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Preface 


The beautiful thing about learning is nobody can take it away from you. 

—B.B. King (5 October 1997) 

Learning a Computer programming language is like a toddler’s first Steps. You stumble, and fall, but when you Start walking, programming becomes second nature. And once you 
Start programming, you never cease evolving or picking up new tricks. Learn one programming language, and you will "know" them all — the logic of the world will begin to 
unravel around you. 

Are you new to programming? 

If you have chosen Java as your first programming language, be assured that Java is also the first choice for Computer Science programs in many universities. Its simple and intuitive 
syntax, or grammar, helps beginners feel at ease with complex programming constructs quickly. 

However, Java is not a basic programming language. In fact, NASA used Java as the driving force (quite literally) behind its Mars Rover missions. Robots, air traffic control Systems 
and the self-checkout barcode Scanners in your favorite supermarkets can all be programmed in Java. 
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Programming with Java™ 

By now, you might truly be able to grasp the power of the Java programming language. With Java, there are many possibilities. 

Yet not every programmer gets to program applications that take unmanned vehicles onto other planets. Software that we 
encounter in our daily life is somewhat humble in that respect. Software in Java, however, covers a vast area of the computing 
ecosphere. Here are just a few examples of the ubiquitous nature of Java applications in real-life: 

■ OpenOffice.org, a desktop Office management suite that rivals the Microsoft Office suite has been written in Java. 

■ The populär building game Minecraft is written in Java. 

■ Online browser-based games like Runescape, a 3D massively multi-player online role playing game (MMORPG), run on graphics routines, 3D rendering and networking 
capabilities powered by the Java programming language. 

■ Two of the world’s renowned digital video recorders, TiVo and BSkyB’s Sky+ use built-in live tele vision recording Software to record, re wind and play your favorite tele vision 
shows. These applications make extensive use of the Java programming language. 

The above mentioned applications illustrate the reach and ubiquity of Java applications. Here's another fact: almost 80% of mobile phone vendors adopt Java as their primary 
platform for the development of applications. The most widely used mobile-based operating System, Android, uses Java as one of its key application platforms — developers are 
encouraged to develop applications for Android in the Java programming language. 

What can Java not do? 

Well, to be honest, there is nothing that Java can’t do, at least for application programming. Java is a "complete" language; the only limits are programmer imagination and ability. 
This book aims to get you acquainted with the basics of the language so you can create the Software masterpiece of your dreams. The one area where Java can’t be used is for direct 
interaction with Computer hardware. If you want to write an operating System, you will need to look elsewhere! 



This stunning image of the sunset on planet Mars 
wouldn't have been possible without Java. 


About This Book 


The Java Programming Wikibook is a shared effort in amassing a comprehensive guide of the complete Java platform — from programming advice and tutorials for the desktop 
Computer to programming on mobile phones. The information presented in this book has been conceptualised with the combined efforts of various contributors, and anonymous 
editors. 

The primary purpose of this book is to teach the Java programming language to an audience of beginners, but its progressive layout of tutorials increasing in complexity, it can be 
just as helpful for intermediate and experienced programmers. Thus, this book is meant to be used as: 

■ a collection of tutorials building upon one another in a progressive manner; 

■ a guidebook for efficient programming with the Java programming language; and, 

■ a comprehensive manual resource for the advanced programmer. 

This book is intended to be used in conjunction with various other online resources, such as: 

■ the Java platform API documentation (http://download.oracle.eom/javase/7/does/api/overview-summary.html); 

■ the official Java website (http://www.oracle.com/us/technologies/java/index.html); and, 

■ active Java communities online, such as Java.net (http://home.java.net) and JavaRanch (http://www.javaranch.com), etc. 

Who should read this book? 

Everything you would need to know to write Computer programs would be explained in this book. By the time you finish reading, you will find yourself proficient enough to tackle 
just about anything in Java and programs written using it. This book serves as the first few stepping stones of many you would need to cross the unfriendly waters of Computer 
programming. We have put a lot of emphasis in structuring this book in a way that lets you Start programming from scratch, with Java as your preferred language of choice. This 
book is designed for you if any one of the following is true. 

■ You are relatively new to programming and have heard how easy it is to learn Java. 

■ You had some BASIC or Pascal in school, and have a grasp of basic programming and logic. 

■ You already know and have been introduced to programming in earlier versions of Java. 

■ You are an experienced developer and know how to program in other languages like C++, Visual Basic, Python, Ruby, etc. 

■ You’ve heard that Java is great for web applications and web Services programming. 

Although this book is generally meant to be for readers who are beginning to learn programming; it can be highly beneficial for intermediate and advanced programmers who may 
have missed out on some vital information. After completing this book you should be able to solve many complicated problems using the Java skills presented in the following 
chapters. Once you finish, you are also encouraged to undertake ambitious programming projects of your own. 

This book assumes that the reader has no prior knowledge of programming in Java, or for that matter, any object-oriented programming language. Practical examples and exercises 
following each topic and module make it easy to understand the Software development methodology. If you are a complete beginner, we suggest that you move slowly through this 
book and complete each exercise at your own pace. 

How to use this book 

This book is a reference book of the Java language and its related technologies. Its goal is to give a complete picture of Java and its technologies. While the book can be read from 
the beginning to end, it is also designed to have individual sections that can be read independently. To help find information quickly, navigation boxes are given in the online Version 
for access to individual topics. 

This book is divided to sections. Pages are grouped together into section topics. To make this book expandable in the future via the addition of new sections, the sections 
navigation-wide are independent from each other. Each section can be considered as a mini book by itself. Pages that belong to the same topic can be navigated by the links on the 
right hand side. 

How can you participate 

Content is constantly being updated and enhanced in this book as is the nature of wiki-based content. This book is therefore in a constant state of evolution. Any Wikibooks users 
can participate in helping this book to a better Standard as both a reader, or a contributor. 

As a reader 
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If you are interested in reading the content present in this book, we encourage you to: 

■ share comments about the technical accuracy, content, or Organization of this book by telling the contributors in the Discussion section for each page. You can find the link 
Discussion on each page in this book leading you to appropriate sections for discussion. Leave a signature when providing feedback, writing comments, or giving Suggestion 

on the Discussion pages. This can be achieved by appending —-to your messages. Do not add your signatures to the Book pages, they are only meant for the 

Discussion pages. 

■ share news about the Java Programming Wikibook with your family and friends and let them know about this comprehensive Java guide online. 

■ become a contributing author, if you think that you have information that could fill in some missing gaps in this book. 

As a contributor 

If you are intent on writing content for this book, you need to do the following: 

■ When writing content for this book, you can always pose as an anonymous contributor, however we recommend you sign-in into the Wikibooks website when doing so. It 
becomes easier to track and acknowledge changes to certain parts of the book. Furthermore, the opinions and views of logged-in users are given precedence over anonymous 
users. 

■ Once you have started contributing content for this book, make sure that you add your name to the contributor list. 

■ Be bold and try to follow the conventions for this Wikibook. It is important that the conventions for this book be followed to the letter to make content consistent and reliable 
throughout. 


History 

On 23 May 1995, John Gage, the director of the Science Office of the Sun Microsystems along with Marc Andreesen, co-founder and executive vice President at Netscape 
announced to an audience of SunWorld™ that Java technology wasn’t a myth and that it was a reality and that it was going to be incorporated into Netscape Navigator! ^ 

At the time the total number of people working on Java was less than 30J 1 ! This team would shape the future in the next decade and no one had any idea as to what was in störe. 
From being the mind of an unmanned vehicle on Mars to the operating environment on most of the consumer electronics, e.g. cable set-top boxes, VCRs, toasters and also for 
personal digital assistants (PDAs) Java has come a long way from its inception. Let's see how it all began. 

Earlier programming languages 

Before Java emerged as a programming language, C++ was the dominant player in the trade. The primary goal of the creators of Java was to create a language that could tackle 
most of the things that C++ offered while getting rid of some of the more tedious tasks that came with the earlier languages. 

Computer hardware went through a performance and price revolution from 1972 to 1991. Better, faster hardware was available at ever lower prices and the demand for big and 
complex Software exponentially increased. To accommodate the demand, new development technologies were invented. 

The C language developed in 1972 by Dennis Ritchie had taken a decade to become the most populär language amongst programmers working on PCs and similar platforms (other 
languages, like COBOL and FORTRAN, dominated the mainframe market). But, with time programmers found that programming in C became tedious with its structural syntaxJ 3 ! 
Although, people attempted to solve this problem, it would be later that a new development philosophy was introduced, one named Object-Oriented Programming. With OOP, you 
can write code that can be reused later without rewriting the Code over and over again. In 1979, Bjarne Stroustrup developed C++, an enhancement to the C language with included 
OOP fundamentals and features. 

The Green team 

Behind closed doors, a project was initiated in December of 1990, whose aim was to create a programming tool that could render obsolete the C 
and C++ programming languages. Engineer Patrick Naughton had become extremely frustrated with the state of Sun’s C++ and C APIs 
(Application Programming Interfaces) and tools. While he was considering to move towards NeXT, he was offered a chance to work on new 
technology and the Stealth Project was started, a secret nobody but he knew. 

This Stealth Project was later named the Green Project when James Gosling and Mike Sheridan joined Patrick! ^ Over the period of time that 
the Green Project teethed, the prospects of the project started becoming clearer to the engineers working on it. No longer was its aim to create a 
new language far superior to the present ones, but it aimed to target the language to devices other than the Computer. 

Staffed at 13 people, they began work in a small office on Sand Hill Road in Menlo Park, California. This team would be called Green Team 
henceforth in time. The project they underwent was chartered by Sun Microsystems to anticipate and plan for the "next-wave" in computing. 

For the team, this meant at least one significant trend, that of the convergence of digitally controlled consumer devices and Computers! 1 ! 





James Gosling, architect and 
designer of the Compiler for the 
Java technology 


Reshaping thought 

The team started thinking of replacing C++ with a better Version, a faster Version, a responsive Version. But the one thing they hadn’t thought of, as of yet, was that the language 
they were aiming for had to be developed for an embedded System with limited resources. An embedded System is a Computer System scaled to a minimalistic interface demanding 
only a few functions from its design. For such a System, C++ or any successor would seem too large as all the languages at the time demanded a larger footprint than what was 
desired. The team thus had to think in a different way to go about solving all these problems. 

Co-founder of Sun Microsystems, Bill Joy, envisioned a language combining the power of Mesa and C in a paper he wrote for the engineers at Sun named Further. Gathering ideas, 
Gosling began work on enhancing C++ and named it "C++ ++ —", a pun on the evolutionary structure of the language's name. The ++ and — meant, putting in and taking out stuff. 
He soon abandoned the name and called it Oakl 1 ! after the tree that stood outside his office. 
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Table 1: Who's who of the Java technology*^ 

Has worked for GT (Green Team), FP (FirstPerson) and JP (Java Products Group) 


Name 

GT 

FP 

JP 

Details 

Lisa Friendly 


/ 

✓ 

FirstPerson employee and member of the Java Products Group 

John Gage 




Science Office (Director), Sun Microsystems 

James Gosling 

/ 

/ 

✓ 

Lead engineer and key architect of the Java technology 

Bill Joy 




Co-founder and VP, Sun Microsystems; Principal designer of the UC Berkeley, version of the UNIX® OS 

Jonni Kanerva 


✓ 


Java Products Group employee, author of The Java FAQ1 

Tim Lindholm 


✓ 

/ 

FirstPerson employee and member Java Products Group 

Scott McNealy 




Chairman, President, and CEO of Sun Microsystems 

Patrick Naughton 

/ 

/ 


Green Team member, FirstPerson co-founder 

George Paolini 




Corporate Marketing (Director), Sun's Java Software Division 

Kim Polese 


✓ 


FirstPerson product marketing 

Lisa Poulson 




Original director of public relations for Java technology (Burson-Marsteller) 

Wayne Rösing 


✓ 


FirstPerson President 

Eric Schmidt 




Former Sun Microsystems Chief Technology Officer 

Mike Sheridan 

/ 



Green Team member 


The demise of an idea, birth of another 

By now, the work on Oak had been significant but come the year 1993, people saw the demise of set-top boxes, interactive TV and the PDAs. A failure that completely ushered the 
inventors’ thoughts to be reinvented. Only a miracle could make the project a success now. And such a miracle awaited anticipation. 

National Center for Supercomputing Applications (NCSA) had just unveiled its new commercial web browser for the internet the previous year. The focus of the team, now diverted 
towards where they thought the "next-wave" of computing would be — the internet. The team then divulged into the realms of creating the same embeddable technology to be used 
in the web browser space calling it an applet — a small application. Keeping all of this in mind, the team created a list of features tackling the C++ problems. In their opinion, the 
project should ... 

■ .. be simple and gather tested fundamentals and features from the earlier languages in it, 

■ .. have Standard sets of APIs with basic and advanced features bundled with the language, 

■ .. get rid of concepts requiring direct manipulation of hardware (in this case, memory) to make the language safe, 

■ .. be platform independent and may written for every platform once (giving birth to the WORA idiom), 

■ .. be able to manipulate network programming out-of-the-box, 

■ .. be embeddable in web browsers, and ... 

■ .. have the ability for a single program to multi-task and do multiple things at the same time. 

The team now needed a proper identity and they decided on naming the new technology they created Java ushering a new generation of products for the internet boom. A 
by-product of the project was a cartoon named "Duke" created by Joe Parlang which became its identity then. 

Finally at the Sun World™ Conference, Andreesen unveiled the new technology to the masses. Riding along with the explosion of interest and publicity in the Internet, Java quickly 
received widespread recognition and expectations grew for it to become the dominant Software for browser and consumer applicationsJ 2 ! 

Initially Java was owned by Sun Microsystems, but later it was released to open source; the term Java was a trademark of Sun Microsystems. Sun released the source Code for its 
HotSpot Virtual Machine and Compiler in November 2006, and most of the source code of the dass library in May 2007. Some parts were missing because they were owned by third 
parties, not by Sun Microsystems. The released parts were published under the terms of the GNU General Public License, a free Software license. 

Versions 

Unlike C and C++, Java's growth is pretty recent. Here, we'd quickly go through the development paths that Java took with age. 
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Earlier revisions 1.0 - 1.1 


Java 2 Version 1.2 -1.4 


Tiger (version 1.5) 


Future versions 


Java mal largely being dcrveloped and refined 
for specific programmability on a Computer 
Had gained acceptance in the Internet market. 


Java version 1.2 was by farthe most stable 
and readily robust v ersion of Jov a and w as 
one the mein reasons for the success of the 
Jov a technology. 


With Java like languages being buik by 
competitors, Java had to reivent itself 
completely (not just the brand, but the 
internal workings of its Compiler and the 
JVM) to render it fasterthan alternatives. 


Involving more Customers and 
developers into the development for 
the focus on both, the brand and the 
platform. 


Development of Java over the years. From version 1.0 to version 1.7, Java has displayed a steady growth. 


Initial Release (versions 1.0 and 1.1) 

Introduced in 1996 for the Solaris, Windows, Mac OS Classic and Linux, Java was initially released as the Java Development Kit 1.0 (JDK 1.0). This included the Java runtime (the 
virtual machine and the dass libraries), and the development tools (e.g., the Java Compiler). Later, Sun also provided a runtime-only package, called the Java Runtime Environment 
(JRE). The first name stuck, however, so usually people refer to a particular version of Java by its JDK version (e.g., JDK 1.0). 

Java 2 (version 1.2) 

Introduced in 1998 as a quick fix to the former versions, version 1.2 was the Start of a new beginning for Java. The JDKs of version 1.2 and later versions are often called Java 2 as 
well. For example, the official name of JDK 1.4 is The Java(TM) 2 Platform, Standard Edition version 1.4. 

Major changes include: 

■ Rewrite the event handling (add Event Listeners) 

■ Change Thread synchronizations 

■ Introduction of the JIT-Just in time Compilers 

Kestrel (Java 1.3) 

Released in 8 May 2000. The most notable changes were: 
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■ HotSpot JVM included (the HotSpot JVM was first released in April, 1999 for the J2SE 1.2 JVM) 

■ RMI was modified to support optional compatibility with CORBA 

■ JavaSound 

■ Java Naming and Directory Interface (JNDI) included in core libraries (previously available as an extension) 

■ Java Platform Debugger Architecture (JPDA) 

■ Synthetic proxy classes 

Merlin (Java 1.4) 

Released in 6 February 2002, Java 1.4 has improved programmer productivity by expanding language features and available APIs: 

■ Assertion 

■ Regular Expression 

■ XML processing 

■ Cryptography and Secure Socket Layer (SSL) 

■ Non-blocking I/O (NIO) 

■ Logging 

Tiger (version 1.5.0; Java SE 5) 

Released in September 2004 
Major changes include: 

■ Generics - Provides compile-time type safety for collections :and eliminates the drudgery of casting. 

■ Autoboxing/unboxing - Eliminates the drudgery of manual conversion between primitive types (such as 

■ Enhanced for - Shorten the for loop with Collections use. 

■ Static imports - Lets you import all the static part of a dass. 

■ Annotation/Metadata - Enabling tools to generate code and deployment descriptors from annotations in 
style where the programmer says what should be done and tools emit the code to do it. Annotations can 
reflection APIs added in Java 5. 

■ JVM Improvements - Most of the run time library is now mapped into memory as a memory image, as opposed to being loaded from a series of dass files. Large portion 
of the runtime libraries will now be shared among multiple JVM instances. 

Mustang (version 1.6.0; Java SE 6) 

Released on 11 December 2006J 4 ^ 

What's New in Java SE 6: 

■ Web Services - First-class support for writing XML web Service dient applications. 

■ Scripting - You can now mix in JavaScript technology source code, useful for prototyping. Also useful when you have teams with a variety of skill sets. More advanced 
developers can plug in their own scripting engines and mix their favorite scripting language in with Java code as they see fit. 

■ Database - No more need to find and configure your own JDBC database when developing a database application. Developers will also get the updated JDBC 4.0, a well-used 
API with many important improvements, such as special support for XML as an SQL datatype and better integration of Binary Large OBjects (BLOBs) and Character Large 
OBjects (CLOBs) into the APIs. 

■ More Desktop APIs - GUI developers get a large number of new tricks to play like the ever populär yet newly incorporated SwingWorker utility to help you with threading in 
GUI apps, JTable sorting and filtering, and a new facility for quick splash screens to quiet impatient users. 

■ Monitoring and Management - The really big deal here is that you don’t need to do anything special to the startup to be able to attach on demand with any of the monitoring 
and management tools in the Java SE platform. 

■ Compiler Access - Really aimed at people who create tools for Java development and for frameworks like JavaServer Pages (JSP) or Personal Home Page construction kit 
(PHP) engines that need to generate a bunch of classes on demand, the Compiler API opens up programmatic access to javac for in-process Compilation of dynamically 
generated Java code. The Compiler API is not directly intended for the everyday developer, but for those of you deafened by your screaming inner geek, roll up your sleeves 
and give it a try. And the rest of us will happily benefit from the tools and the improved Java frameworks that use this. 

■ Pluggable Annotations allows programmer to write annotation processor so that it can analyse your code semantically before javac compiles. For example, you could write an 
annotation processor that verifies whether your program obeys naming conventions. 

■ Desktop Deployment - At long last, Java SE 6 unifies the Java Plug-in technology and Java WebStart engines, which just makes sense. Installation of the Java WebStart 
application got a much needed makeover. 

■ Security - Java SE 6 has simplified the job of its security administrators by providing various new ways to access platform-native security Services, such as native Public Key 
Infrastructure (PKI) and cryptographic Services on Microsoft Windows for secure authentication and communication, Java Generic Security Services (Java GSS) and 
Kerberos Services for authentication, and access to LDAP Servers for authenticating users. 

■ The -lities: Quality, Compatibility, Stability - Bug fixes ... 

Dolphin (version 1.7.0; Java SE 7) 

Released on 28 July 2011. 

Feature additions for Java 7 include:^] 

■ JVM support for dynamic languages, following the prototyping work currently done on the Multi Language Virtual Machine 

■ Compressed 64-bit pointers^ Available in Java 6 with -XX:+UseCompressedOops (http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html) 

■ Small language changes (grouped under a project named Coin):^ 

■ Strings in switch^l 

■ Automatic resource management in try-statementf 9 l 

■ Improved type inference for generic instance Creation^ 1(4 

■ Simplified varargs method declaration^ 11 ! 

■ Binary integer literals^ 12 ^ 

■ Allowing underscores in numeric literals^ 13 ] 


int) and wrapper types (such as Integer). 

the source code. This leads to a "declarative" programming 
be inspected through source parsing or by using the additional 
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■ Catching multiple exception types and rethrowing exceptions with improved type checkingf 14 ! 

■ Concurrency Utilities under JSR 166^ 

■ New file I/O library to enhance platform independence and add support for metadata and symbolic links. The new packages are java.nio.file and java.nio.file.attributef 16 h 17 l 

■ Library-level support for Elliptic curve cryptography algorithms 

■ An XRender pipeline for Java 2D, which improves handling of features specific to modern GPUs 

■ New platform APIs for the graphics features originally planned for release in Java Version 6ul0 

■ Enhanced library-level support for new network protocols, including SCTP and Sockets Direct Protocol 

■ Upstream Updates to XML and Unicode 

Lambda (Java's implementation of lambda functions), Jigsaw (Java's implementation of modules), and part of Coin were dropped from Java 7. Java 8 will be released with the 
remaining features in summer 2013 J 18 ] 
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Java OverView 


The new features and Upgrades included into Java changed the face of programming environment and gave a new definition to Object Oriented Programming (OOP in short). But 
unlike its predecessors, Java needed to be bundled with Standard functionality and be independent of the host platform. 

The primary goals in the creation of the Java language: 

■ It is simple. 

■ It is object-oriented. 

■ It is independent of the host platform. 

■ It contains language facilities and libraries for networking. 

■ It is designed to execute code from remote sources securely. 

The Java language introduces some new features that did not exist in other languages like C and C++. 

Object orientation 

Object orientation ("OO"), refers to a method of programming and language technique. The main idea of OO is to design 
Software around the "things" (i.e. objects) it manipulates, rather than the actions it performs. 

As the hardware of the Computer advanced, it brought about the need to create better Software techniques to be able to create 
ever increasing complex applications. The intent is to make large Software projects easier to manage, thus improving quality and 
reducing the number of failed projects. Object oriented solution is the latest Software technique. 

Assembly languages 

Software techniques started with the assembly languages, that was close to machine instruction and was easy to convert 
into executable code. Each hardware had its own assembly language. Assembly language contains low level instructions 
like move data from memory to hardware registers, do arithmetic operations, and move data back to memory. 

Programmers had to know the detailed architecture of the Computer in Order to write programs. 

Procedural languages 

After the assembly languages, high level languages were developed. Here the language Compiler is used to convert the high level program to machine instructions, freeing up 
the programmers the bürden of knowing the Computer hardware architecture. To promote the re-use of code, and to minimize the use of GOTO instruction, "procedural" 
techniques were introduced. This simplified the creation and maintenance of Software control flow, but they left out the Organization of data. It became a nightmare to debug 
and maintain programs having many global variables. Global variables contain data that can be modified anywhere in the application. 

Object oriented languages 

In OO languages, data is taken seriously with information hiding. Procedures were replaced by Objects. Objects contain data as well as control flow. Our thinking has to shift 
from procedures to interaction between objects. 



Object oriented programming can be represented with 
UML diagrams. 
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Platform dependence 

In C or C++ programming, you Start to write a source code: 


.C 


... you compile it to a machine code file: 




IOI4lOOO 

10I440PI 

.c 


•0191001 
• 1091 1 1 | 


... and then you execute it: 
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.C 


90102001 
• 1009 1 1 1 




In this Situation, the machine code file and its execution are specific to the platform (Windows, Linux, Mac OS,...) it was compiled for, that is to say to the targetedplatform : 









10199001 
91011010 
•010)001 
• 109911t 






... because the compiled file is a machine code file designed to work on a specific platform and hardware. It would have produced a different results/output for another platform. So 
if you want your program to run on several platforms, you have to compile your program several times: 
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•OA 

It poses greater vulnerability risks. Note here that when a certain code is compiled into an executable format, the executable cannot be changed dynamically. It would need to be 
recompiled from the changed code for the changes to be reflected in the finished executable. Modularity (dividing code into modules) is not present in Java's predecessors. If 
instead of a single executable, the output application was in the form of modules, one could easily change a single module and review changes in the application. In C/C++ on the 
other hand, a slight change in code required the whole application to be recompiled. 

The idea of Java is to compile the source code into an intermediate language that will be interpreted. 

The source code The intermediate file The interpretor 

The intermediate language is the byte code. The interpretor is the Java Virtual Machine (JVM). The byte code file is universal and the JVM is platform specific: 





So a JVM should be coded for each platform. And that’s the case. So you just have to generate a unique byte code file (a . dass file). 

The first implementations of the language used an interpreted virtual machine to achieve portability, and many implementations still do. These implementations produce programs 
that run more slowly than the fully-compiled programs created by the typical C++ Compiler, so the language suffered a reputation for producing slow programs. Since Java 1.2, Java 
VM produces programs that run much faster, using multiple techniques. 

The first of these is to simply compile directly into native code like a more traditional Compiler, skipping bytecode entirely. This achieves great performance, but at the expense of 
portability. This is not really used any more. 

Another technique, the just-in-time (JIT) Compiler, compiles the Java bytecode into native code at the time the program is run, and keep the compiled code to be used again and 
again. More sophisticated VMs even use dynamic recompilation, in which the VM can analyze the behavior of the running program and selectively recompile and optimize critical 
parts of the program. Both of these techniques allow the program to take advantage of the speed of native code without losing portability. 
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Portability is a technically difficult goal to achieve, and Java's success at that goal is a matter of some controversy. Although it is indeed possible to write programs for the Java 
platform that behave consistently across many host platforms, the large number of available platforms with small errors or inconsistencies led some to parody Sun's "Write once, run 
anywhere" slogan as "Write once, debug everywhere". 

Standardization 

C++ was built atop the C language and as a result divergent ways of doing the same thing manifested around the language. For instance, creating an object could be done in three 
different ways in C++. Furthermore, C++ did not come with a Standard library bundled with its Compilers. Instead, it relied on resources created by other programmers; Code which 
rarely fit together. 

In Java, standardized libraries are provided to allow access to features of the host machines (such as graphics and networking) in unified ways. The Java language also includes 
support for multi-threaded programs—a necessity for many networking applications. 

Platform independent Java is, however, very successful with Server side applications, such as web Services, servlets, or Enterprise JavaBeans. 

Java also made progress on the Client side, first it had Abstract Window Toolkit (AWT), then Swing, and the most recent Client 
side library is the Standard Widget Toolkit (SWT). It is interesting to see how they tried to handle the two opposing consuming 
forces. Those are : 

Efficient, fast code; port to most populär hardware (write once, test anywhere) 

Use the underlying native subroutine to create a GUI component. This approach was taken by AWT, and SWT. 

Portability to any hardware where JVM ported (write once, run anywhere) 

To achieve this to the latter, the Java toolkit should not rely on the underlying native user interface. Swing tooks this 
approach. 

It is interesting to see how the approach was switched back and forth. AWT —► Swing —► SWT. 


Secure execution 

With the high-level of control built into the language to manipulate hardware, a C/C++ programmer could access almost any 
resource, either hardware or Software on the System. This was intended to be one of the languages' strong points, but this very 
flexibility led to confusion and complex programming practices. 

Error handling 


The old way of error handling was to let each function return an error code then let the caller check what was returned. The 
problem with this method was that if the return code was full of error-checking Codes, this got in the way of the original one that 
was doing the actual work, which in turn did not make it very readable. 

In the new way of error handling, functions/methods do not return error codes. Instead, when there is an error, an exception is 
thrown. The exceptions can be handled by the catch keyword at the end of a try block. This way, the code that is calling the 
function does not need to be mangled with error checking codes, thus making the code more readable. This new way of error 
handling is called Exception handling. 

Exception handling was also added to C++. However, there are two differences between Java and C++ Exception handling: 

■ In Java, the exception that is thrown is a Java object like any other object in Java. It only has to implement Throwabie interface. 

■ In Java, the Compiler checks whether an exception may be caught or not. The Compiler gives an error if there is no catch block for a thrown exception. 

The optional exception handling in the Java predecessors leads the developers not to care about the error handling. As a consequence, unexpected errors often occur. Java forces 
the developers to handle exceptions. The programmer must handle exception or declare that the user must handle it. Someone must handle it. 

Networking capabilities 

However powerful, the predecessors of Java lacked a Standard feature to network with other Computers, and usually relied on the platforms' intricate networking capabilities. With 
almost all network protocols being standardized, the creators of Java technology wanted this to be a flagship feature of the language while keeping true to the spirit of earlier 
advances made towards standardizing Remote Procedure Call. Another feature that the Java team focused on was its integration in the World Wide Web and the Internet. 

The Java platform was one of the first Systems to provide wide support for the execution of code from remote sources. The Java language was designed with network computing in 
mind. 

An applet could run within a user's browser, executing code downloaded from a remote HTTP Server. The remote code runs in a highly restricted "sandbox", which protects the user 
from misbehaving or malicious code; publishers could apply for a certificate that they could use to digitally sign applets as "safe", giving them permission to break out of the 
sandbox and access the local file System and network, presumably under user control. 

Dynamic dass loading 

In conventional languages like C and C++, all code had to be compiled and linked to one executable program, before execution. In Java, classes are compiled as needed. If a dass is 
not needed during an execution phase, that dass is not even compiled into byte code. 

This feature comes in handy especially in network programming when we do not know, beforehand, what code will be executed. A running program could load classes from the file 
System or from a remote Server. 

Also this feature makes it theoretically possible for a Java program to alter its own code during execution, in Order to do some self-learning behavior. It would be more realistic to 
imagine, however, that a Java program would generate Java code before execution, and then, that code would be executed. With some feedback mechanism, the generated code 
could improve over time. 

Automatic memory garbage collection 

In conventional languages like C and C++, the programmer has to make sure that all memory that was allocated is freed. Memory leaks became a regulär nuisance in instances 
where the programmers had to manually allocate the system’s memory resources. 
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Memory resources or buffers have specific modes of Operation for optimal performance. Once a buffer is filled with data, it needs to be cleaned up after there is no further use for 
its content. If a programmer forgets to clean it in his/her code, the memory is easily overloaded. Programming in C/C++ languages became tedious and unsafe because of these very 
quirks, and programs built in these languages were prone to memory leakages and sudden System crashes — sometimes even harming the hardware itself. Freeing memory is 
particularly important in Servers, since it has to run without stopping for days. If a piece of memory is not freed after use and the Server just keeps allocating memory, that memory 
leak can take down the Server. 

In Java, freeing up memory is taken out of the programmers hands; the Java Virtual Machine keeps track of all used memory. When memory is not used any more it is automatically 
freed up. A separate task is running in the background by the JVM, freeing up unreferenced, unused memory. That task is called the Garbage Collector. 

The Garbage Collector is always running. This automatic memory garbage collection feature makes it easy to write robust Server side programs in Java. The only thing the 
programmer has to watch for is the speed of object creation. If the application is creating objects faster than the Garbage Collector can free them, it can cause memory problems. 
Depending on how the JVM is configured, the application either can run out of memory by throwing the NotEnoughMemoryException, or can halt to give time for the Garbage 
Collector to do its job. 

Applet 

The Java creators created the concept of the applet. A Java program can be run in a client browser program. Java was released in 1995; the time when the Internet was becoming 
more available and familiär to the general public. The promise of Java was in the client browser-side in that code would be downloaded and executed as a Java applet in the client 
browser program. 

See also Java Programming/Applets. 

Forbidden bad practices 

Over the years, some features in C/C++ programming became abused by the programmers. Although the language allows it, it was known as bad practices. So the creators of Java 
have disabled them: 

■ Operator overloading 

■ Multiple inheritance 

■ Friend classes (access another object's private members) 

■ Restrictions of explicit type casting (related to memory management) 

Evaluation 

In most people’s opinions, Java technology delivers reasonably well on all these goals. The language is not, however, without drawbacks. Java tends to be more high-level than 
similar languages (such as C++), which means that the Java language lacks features such as hardware-specific data types, low-level pointers to arbitrary memory addresses, or 
programming methods like operator overloading. Although these features are frequently abused or misused by programmers, they are also powerful tools. However, Java technology 
includes Java Native Interface (JNI), a way to call native code from Java language code. With JNI, it is still possible to use some of these features. 

Some programmers also complain about its lack of multiple inheritance, a powerful feature of several object-oriented languages, among others C++. The Java language separates 
inheritance of type and implementation, allowing inheritance of multiple type definitions through interfaces, but only single inheritance of type implementation via dass hierarchies. 
This allows most of the benefits of multiple inheritance while avoiding many of its dangers. In addition, through the use of concrete classes, abstract classes, as well as interfaces, a 
Java language programmer has the Option of choosing full, partial, or zero implementation for the object type he defines, thus ensuring maximum flexibility in application design. 

There are some who believe that for certain projects, object Orientation makes work harder instead of easier. This particular complaint is not unique to the Java language but applies 
to other object-oriented languages as well. 


The Java Platform 


The Java platform is the name given to the computing platform from Oracle that helps users to run and develop Java applications. The platform does not just enable a user to run 
and develop a Java application, but also features a wide variety of tools that can help developers work efficiently with the Java programming language. 

The platform consists of two essential softwares: 

■ the Java Runtime Environment (JRE), which is needed to run Java applications and applets; and, 

■ the Java Development Kit (JDK), which is needed to develop those Java applications and applets. If you have installed the JDK, you should know that it comes equipped 
with a JRE as well. So, for all the purposes of this book, you would only require the JDK. 

In this section, we would explore in further detail what these two Software components of the Java platform do. 

Java Runtime Environment (JRE) 

Any piece of code written in the Java programming language can be run on any operating System, platform or architecture — in fact, it can be run on any device that supports the 
Java platform. Before Java, this amount of ubiquity was very hard to achieve. If a Software was written for a Unix-based System, it was impossible to run the same application on a 
Windows System — in this case, the application was native only to Unix-based Systems. 

A major milestone in the development of the Java programming language was to develop a special runtime environment that would execute any Java application independent of the 
computer's operating System, platform or architecture. 

The Java Runtime Environment (JRE) sits on top of the machine's operating System, platform and architecture. If and when a Java application is run, the JRE acts as a liaison 
between the underlying platform and that application. It interprets the Java application to run in accordance with the underlying platform, such that upon running the application, it 
looks and behaves like a native application. The part of the JRE that accomplishes this complex liaison agreement is called the Java Virtual Machine (JVM). 


Figure 1: Java applications can be written once and run anywhere. This feature of the Java platform 

is commonly abbreviated to WORA in formal Java texts. 
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Executing native Java code (or byte-code) 


Native Java applications are preserved in a special format called the byte-code. Byte-code remains the same, no matter what hardware architecture, operating System, or Software 
platform it is running under. On a file-system, Java byte-code resides in files that have the .dass (also known as a class file ) or the . jar (also known as a Java archive ) extension. 
To run byte-code, the JRE comes with a special tool (appropriately named java). 

Suppose your byte-code is called someApplication. dass. If you want to execute this Java byte-code, you would need to use the following command in Command Prompt (on 
Windows) or Terminal (on Linux or Mac OS): 



Execution 


i$ java SomeApplication 

l_ 



If you want to execute a Java byte-code with a . jar extension (say, SomeApplication. jar), you would need to use the following command in Command Prompt (on Windows) or 
Terminal (on Linux or Mac OS): 

Execution with a jar 

j-| 

i$ java -jar SomeApplication . jar s 

I_! 

Not all Java class files or Java archives are executable. Therefore, the java tool would only be able to execute files that are executable. Non-executable class files and Java 
archives are simply called class libraries. 


Do you have a JRE? 


Most Computers come with a pre-installed copy of the JRE. If your Computer doesn’t have a JRE, then the above commands would not work. You can always check what Version of 
the JRE is installed on the Computer by writing the following command in Command Prompt (on Windows) or Terminal (on Linux or Mac OS): 



Java Version 


i$ java -Version 

l_ 


Java Virtual Machine (JVM) 

Quite possibly, the most important part of the JRE is the Java Virtual Machine (JVM). The JVM acts like a virtual processor, enabling Java applications to be run on the local 
System. It's main purpose is to interpret ( read translate) the received byte-code and make it appear as native code. The older Java architecture used this process of interpretation to 
execute Java byte-code. Even though the process of interpretation brought the WORA principle to diverse machines, it had a drawback — it consumed a lot of time and clocked the 
System processor intensively to load an application. 


Figure 2: A JVM interpreter translates the byte-code line-by-line to make it appear as if a native application is being executed. 
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Just-in-Time Compilation 

Since Version 1.2, the JRE features a more robust JVM. Instead of interpreting byte-code, it down-right converts the Code straight into equivalent native Code for the local System. 
This process of conversion is called just-in-time Compilation or JIT-Compilation. This process only occurs when the byte-code is executed for the first time. Unless the byte-code 
itself is changed, the JVM uses the compiled Version of the byte-code on every successive execution. Doing so saves a lot of time and processor effort, allowing applications to 
execute much faster at the cost of a small delay on first execution. 


Figure 3: A just-in-time Compiler only compiles the byte-code to equivalent native code at first execution. Upon every successive 

execution, the JVM merely uses the already compiled native code to optimize performance. 



Native optimization 

The JVM is an intelligent virtual processor. It has the ability to identify areas within the Java code itself that can be optimized for faster and better performance. Based on every 
successive run of your Java applications, the JVM would optimize it to run even better. 

There are portions of Java code that do not require it to be JIT-compiled at runtime, e.g., the Reflection API; therefore, code that uses such functions are not necessarily 
fully compiled to native code. 



Was JVM the first virtual machine ? 


Java was not the first virtual-machine-based platform, though it is by far the most successful and well-known. Previous uses for virtual machine technology primarily involved 
emulators to aid development for not-yet-developed hardware or operating Systems, but the JVM was designed to be implemented entirely in Software, while making it easy to 
efficiently port an implementation to hardware of all kinds. 


Java Development Kit (JDK) 


The JRE takes care of running the Java code on multiple platforms, however as developers, we are interested in writing pure code in Java which can then be converted into Java 
byte-code for mass deployment. As developers, we do not need to write Java byte-code, rather we write the code in the Java programming language (which is quite similar to writing 
C or C++ code). 

Upon downloading the JDK, a developer ensures that their System has the appropriate JRE and additional tools to help with the development of applications in the Java 
programming language. Java code can be found in files with the extension .java. These files are called Java source files. In Order to convert the Java code in these source files to 
Java byte-code, you need to use the Java Compiler tool installed with your JDK. 


The Java Compiler 

The Java Compiler tool (named javac in the JDK) is the most important utility found with the JDK. In Order to compile a Java source file (say, someApplication. java) to its 
respective Java byte-code, you would need to use the following command in Command Prompt (on Windows) or Terminal (on Linux or Mac OS): 



Compilation 


ijavac SomeApplication . java 

l__ 


This command would convert the SomeApplication. java source file into its equivalent Java byte-code. The resultant byte-code would exist in a newly created file named 
SomeApplication. dass. This process of Converting Java source files into their equivalent byte-codes is known as Compilation. 


Figure 4: The basic Java Compilation process 
SomeApplication.java SomeApplication.dass 
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A list of other JDK tools 

There are a huge array of tools available with the JDK that will all be explained in due time as you progress with the book. These tools are briefly listed below in Order of their 
usage: 

Applet development 
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■ appietviewer — Java applets require a particular environment to execute. Typically, this environment is provided by a browser with a Java plug-in, and a web Server 
serving the appiet. However, during development and testing of an appiet it might be more convenient to Start an appiet without the need to fiddle with a browser and a 
web Server. In such a case, Oracle's appletviewer from the JDK can be used to run an appiet. 

Annotation processing 

For more about annotation processing, read this (http://docs.oracle.eom/javase/l.5.0/docs/guide/apt/GettingStarted.html) 

In Java 1.5 (alias Java 5.0) Oracle added a mechanism called annotations. Annotations allow the addition of meta-data to Java source code, and even provide mechanisms to 
carry that meta-data forth into a compiled .dass files. 

■ apt — An annotation processing tool which digs through source code, finds annotation Statements in the source code and executes actions if it finds known annotations. 
The most common task is to generate some particular source code. The actions apt performs when finding annotations in the source code are not hard-coded into apt. 
Instead, one has to code particular annotation handlers (in Java). These handlers are called annotation processors. It can also be described in a simple way without the 
Oracle terminology: apt can be seen as a source code preprocessor framework, and annotation processors are typically code generators. 

Integration of non-Java and Java code 

■ j avah — A Java dass can call native, or non-Java, code that has been prepared to be called from Java. The details and procedures are specified in the JNI (Java Native 
Interface). Commonly, native code is written in C (or C++). The JDK tool javah helps to write the necessary C code, by generating C header files and C stub code. 

Class library conflicts 

■ ext check — It can be used prior to the installation of a Java extension into the JDK or JRE environment. It checks if a particular Jar file conflicts with an already installed 
extension. This tool appeared first with Java 1.5. 

Software security and cryptography tools 

The JDK comes with a large number of tools related to the security features of Java. Usage of these tools first requires study of the particular security mechanisms. The tools are: 

■ keytool — To manage keys and certificates 

■ jarsigner — To generate and verify digital signatures of JARs (Java ARchives) 

■ policytool — To edit policy files 

■ kinit — To obtain Kerberos v5 tickets 

■ küst — To manage Kerberos credential cache and key table 

■ kt ab — To manage entries in a key table 

The Java archiver 

■ jar — (short for Java archiver) is a tool for creating Java archives or jar files — a file with . jar as the extension. A Java archive is a collection of compiled Java classes 
and other resources which those classes may require (such as text files, configuration files, images) at runtime. Internally, a jar file is really a .zip file. 

The Java debugger 

■ jdb — (short for Java debugger) is a command-line console that provides a debugging environment for Java programs. Although you can use this command line console, 
IDE's normally provide easier to use debugging environments. 

Documenting code with Java 

As programs grow large and complex, programmers need ways to track changes and to understand the code better at each Step of its evolution. For decades, programmers have 
been employing the use of special programming constructs called comments — regions that help declare user definitions for a code snippet within the source code. But comments 
are prone to be verbose and incomprehensible, let alone be difficult to read in applications having hundreds of lines of code. 

■ j avadoc — Java provides the user with a way to easily publish documentation about the code using a special commenting System and the javadoc tool. The javadoc tool 
generates documentation about the Application Programming Interface (API) of a set of user-created Java classes. javadoc reads source file comments from the . java 
source files and generates HTML documents that are easier to read and understand without looking at the code itself. 

■ javap — Where Javadoc provide a detailed view into the API and documentation of a Java class, the javap tool prints information regarding members (constructors, 
methods and variables) in a class. In other words, it lists the class' API and/or the compiled instructions of the class. javap is a formatting disassembler for Java bytecode. 

The native2ascii tool 

nat ive2ascii is an important, though underappreciated, tool for writing properties files — files containing configuration data — or resource bundles — files containing language 
translations of text. 

Such files can contain only ASCII and Latin-1 characters, but international programmers need a full ränge of character sets. Text using these characters can appear in properties 
files and resource bundles only if the non-ASCII and non-Latin- A l characters are converted into Unicode escape sequences (\uXXXX notation). 

The task of writing such escape sequences is handled by native2ascii. You can write the international text in an editor using the appropriate character encoding, then use 
nat ive2ascii to generate the necessary ASCII text with embedded Unicode escape sequences. Despite the name, native2ascii can also convert from ASCII to native, so it is 
useful for Converting an existing properties file or resource bündle back to some other encoding. 

nat ive2ascii makes most sense when integrated into a build System to automate the conversion. 

Remote Method Invocation (RMI) tools 
Java IDL and RMI-IIOP Tools 
Deployment & Web Start Tools 
Browser Plug-In Tools 

Monitoring and Management Tools / Troubleshooting Tools 

With Java 1.5 a set of monitoring and management tools have been added to the JDK, in addition to a set of troubleshooting tools. 
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The monitoring and management tools are intended for monitoring and managing the virtual machine and the execution environment. They allow, for example, monitoring 
memory usage during the execution of a Java program. 

The troubleshooting tools provide rather esoteric insight into aspects of the virtual machine. (Interestingly, the Java debugger is not categorized as a troubleshooting tool.) 
All the monitoring and management and troubleshooting tools are currently marked as "experimental" (which does not affect jdb). So they might disappear in future JDKs. 


Java dass libraries (JCL) 

In most modern operating Systems, a large body of reusable code is provided to simplify the programmer's job. This code is typically provided as a set of dynamically loadable 
libraries that applications can call at runtime. Because the Java platform is not dependent on any specific operating System, applications cannot rely on any of the existing libraries. 
Instead, the Java platform provides a comprehensive set of Standard dass libraries, containing much of the same reusable functions commonly found in modern operating Systems. 

The Java dass libraries serve three purposes within the Java platform. Like other Standard code libraries, they provide the programmer with a well-known set of functions to 
perform common tasks, such as maintaining lists of items or performing complex string parsing. In addition, the dass libraries provide an abstract interface to tasks that would 
normally depend heavily on the hardware and operating System. Tasks such as network access and file access are often heavily dependent on the native capabilities of the platform. 
The Java java.net and java.io libraries implement the required native code internally, then provide a Standard interface for the Java applications to perform those tasks. Finally, some 
underlying platforms may not support all of the features a Java application expects. In these cases, the dass libraries can either emulate those features using whatever is available, or 
provide a consistent way to check for the presence of a specific feature. 

Similar concepts 

The success of the Java platform and the concepts of the write once, run anywhere principle has led to the development of similar frameworks and platforms. Most notable of these 
is the Microsoft’s .NET framework and its open-source equivalent Mono. 

The .NET framework 

The .NET framework borrows many of the concepts and innovations of Java — their alternative for the JVM is called the Common Language Runtime (CLR), while their 
alternative for the byte-code is the Common Intermediate Language (CIL). In fact, the .NET platform had an implementation of a Java-like language called Visual J# (formerly 
known as J++). 

J# is normally not supported with the JVM because instead of compiling it in Java byte-code, the .NET platform compiles the code into CIL, thus making J# different from the Java 
programming language. Furthermore, because J# implements the .NET Base Class Libraries (BCL) instead of the Java Class Libraries, J# is nothing more than a non-standard 
extension of the Java programming language. Due to the lack of interest from developers, Microsoft had to withdraw their support for J#, and focused on a similar programming 
language: C#. 

Third-party Compilers targeting the JVM 

The word Java, by itself, usually refers to the Java programming language which was designed for use with the Java platform. Programming languages are typically outside of the 
scope of the phrase "platform". However, Oracle does not encourage the use of any other languages with the platform, and lists the Java programming language as a core part of the 
Java 2 platform. The language and runtime are therefore commonly considered a single unit. 

There are cases where you might want to program using a different language (say, Python) and yet be able to generate Java byte-code (instead of the Python compiled code) to be 
run with the JVM. Many third-party programming language vendors provide Compilers that can compile code written in their language to Java byte-code. For instance, Python 
developers can use Jython Compilers to compile Python code to the Java byte-code format (as illustrated below). 


Figure 5: Third-party JVM-targeted Compilation for non-Java source Compilation to Java byte-code. Illustrated example 
shows Python source being compiled to both Python compiled code and Java byte-code. 
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Of late, JVM-targeted third-party programming and scripting languages have seen tremendous growth. Some of these languages are also used to extend the functionalities of the 
Java language itself. A few examples include the following: 

■ Groovy 

■ Pizza 

■ GJ (Generic Java) - later officially incorporated into Java SE 5. 

■ NetREXX 


Getting started 

Understanding Systems 

We conceptualize the world around us in terms of Systems. A System is a web of interconnected objects working together in tandem. In the Systems theory, a System is set out as a 
single entity within a world surrounded by an environment. A System interacts with its surrounding environment using messages of two distinct types: 
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■ inputs: messages received from the surrounding environment; and, 

■ Outputs: messages given back to the surrounding environment. 


Figure 1: A simple System interacting with its environment using input and output messages. 
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Life is a complicated mess of interconnected objects sending signals and messages. See the illustration below in figure 2 demonstrating a complex System for an economic ecosphere 
for a single Company. Imagine what this System diagram would be like if you were to add a few more Companies and their sub-systems. Computer Software Systems in general are a 
complex web of further interconnected sub-systems - where each sub-systems may or may not be divided into further sub-systems. Each sub-system communicates with others 
using feedback messages - that is, inputs and Outputs. 


Figure 2: Example of a complex System with multiple sub-systems and interactions 
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The process of abstraction 

Programming is essentially thinking of Solutions to problems in real life as a System. With any programming language, you need to know how to address real-life problems into 
something that could be accurately represented within a Computer System. In order to begin programming with the Java programming language (or in fact, with any programming 
language), a programmer must first understand the basics of abstraction. 

Abstraction is the process of representing real-life problems and object into your programs. 

Suppose a novelist, a painter and a programmer were asked to abstract (i.e., represent) a real-life object in their work. Suppose, the real-life object that needs to be abstracted is an 
animal. Abstraction for a novelist would include writing the description of the animal whilst the painter would draw a picture of the animal - but what about a Computer 
programmer? 

The Java programming language uses a programming paradigm called object-oriented programming (OOP), which shows you exactly what a programmer needs to be doing. 
According to OOP, every object or problem in real-life can be translated into a virtual object within your Computer System. 

Thinking in objects 

In OOP, every abstraction of a real-life object is simply called an object within your code. An object is essentially the most basic representation of a real-life object as part of a 
Computer System. With Java being an object-oriented language, everything within Java is represented as an object. To demonstrate this effect, if you were to define an abstraction of 
an animal in your code, you would write the following lines of code (as you would for any other abstraction): 




iclass Animal { }■ 

l_! 


The code above creates a space within your code where you can Start defining an object; this space is called a dass (or type) definition. All objects need to be defined using a dass 
definition in order for them to be used in your program. Notice the curly brackets - anything you write within these brackets would serve as a definition or specification for your 
object. In the case of the example above, we created a dass definition called Animal for objects that could serve as an abstract representation of any animal in real-life. The way 
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that a Java environment evaluates this code to be a dass definition is by looking at the prefix word we used to begin our dass definition (i.e., dass). Such predefined words in the 
Java language are known as key words and make up the grammar for the language (known as programming syntax). 

Understanding dass definitions and types 

Aristotle was perhaps the first person to think of abstract types or typologies of objects. He started calling them classes - e.g., classes of birds, classes of mammals. Class definitions 
therefore serve the purpose well in defining the common characteristics or types of objects you would be creating. Upon declaring a class definition, you can create objects based on 
that definition. In Order to do so however, you need to write a special syntax that goes like this: 


lAnimal dog = new Animal ();■ 


The code above effectively creates an object called dog based on the class definition for Animal. In non-programmer parlance, the code above would translate into something akin 
to saying, "Create a new object dog of type Animal." A single class definition enables you to create multiple objects as the code below indicates: 


i-1 

lAnimal dog = new Animal () ; 1 

lAnimal cat = new Animal (); 1 

lAnimal camel = new Animal ();■ 

l_ 1 


Basically, you just have to write the code for your class or type definition once, and then use it to create countless numbers of objects based on that specification. Although you 
might not grasp the importance of doing so, this little exercise saves you a lot of time (a luxury that was not readily available to programmers in the pre-Java days). 

Expanding your class definitions 

Although each object you create from a class definition is essentially the same, there has to be a way of differentiating those objects in your code. Object fields (or simply fields) are 
what makes your objects unique from other objects. Let's take our present abstraction for instance. An animal could be a dog, cat, camel or a duck but since this abstraction is of a 
very generic kind, you need to define fields that are common to all of these animals and yet makes the animals stand apart. For instance, you can have two fields: name (a common 
name given to any one of these animals) and legs (the number of limbs any one of these animals would require to walk). As you Start defining your objects, they Start to look like 
this: 


iclass Animal { 

String name; 
int legs; 


In the code above you defined two object fields: 

■ a field called name of type String; and, 

■ a field called legs of type int. 

These special pre-defined types are called data types. The string data type is used for fields that can hold textual values like names, while the int (integer) data type is used for 
fields that can hold numeric values 


Figure 3: In Order to denote the Animal object as a System within the Java Environment, 
you present it as such. Note how fields are presented. 
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In order to demonstrate how fields work, we will go ahead and create objects from this amended Version of our class definition as such: 



lAnimal animall 
lAnimal animal2 


new Animal(); 
new Animal(); 


animall. name 
animall. legs 

animal2. name 
animal2. legs 


"dog" ; 
4; 

"duck" ; 
2 ; 


You can access the fields of your created objects by using the . (dot) or membership operator. In the example above, we created two objects: animall and animai2 of type 
Animal. And since, we had established that each Animal has two fields namely name and legs, we accessed and modified these fields for each of our objects using the membership 
operator to set the two apart. By declaring different values for different objects, we can manipulate their current state. So, for instance: 

■ the animall object is a "dog" with 4 legs to walk with; while, 
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■ the animal2 object is a "duck" with 2 legs tO Wälk with. 

What sets the two objects apart is their current state. Both the objects have different States and thus stand out as two different objects even though they were created from the same 
template or dass definition. 

Adding behavior to objects 

At this point, your objects do nothing more than declare a bunch of fields. Being a System, your objects should have the ability to interact with its environment and other Systems as 
well. To add this capability for interaction, you need to add interactive behavior to your object dass definitions as well. Such behavior is added to dass definitions using a 
programming construct called method. 

In the case of the Animal, you require your virtual representation of an animal to be able to move through its environment. Let’s say, as an analogy, you want your Animal object to 
be able to walk in its environment. Thus, you need to add a method named walk to our object. To do so, we need to write the following code: 



dass Animal { 


String name; 
int legs; 


void walk () { } 

} 


As you write this code, one thing becomes immediately apparent. Just like the dass description, a method has curly brackets as well. Generally, curly brackets are used to define an 
area (or scope) within your object. So the first set of curly brackets defined a scope for your dass definition called the dass-level scope. This new set of curly brackets alongside a 
method defines a scope for the further definition of your method called the method-Ievel scope. 

In this instance, the name of our method is walk. Notice however that the name of our method also features a set of round brackets as well. More than just being visual identifiers 
for methods, these round brackets are used to provide our methods with additional input information called arguments. 

A method therefore enables an object to: 

1. Accept input: Receive some argument(s); 

2. Process information: work on the received argument(s) within its curly brackets; and, 

3. Generate ouput: occasionally, return something back. 

In essence, methods are what makes an object behave more like a System. 

Notice the keyword void before the name of the method - this teils us that the method walk returns nothing. You can set a method to return any data type - it can be a String or an 
int as well. 


Figure 4: The Animal object can now be denoted as having an interaction behavior within the Java Environment 
as illustrated here. Note the difference between the presentation of fields and methods. 


Java Environment 



The process of encapsulation 

By now, we thoroughly understand that any object can interact with its environment and in turn be influenced by it. In our example, the Animal object exposed certain fields - name 
and legs, and a method - walk () to be used by the environment to manipulate the object. This form of exposure is implicit. Using the Java programming language, a programmer 
has the power to define the level of access other objects and the environment have on a certain object. 

Using access modifiers 

Alongside declaring and defining objects, their fields and methods, a programmer also has the ability to define the levels of access on those elements. This is done using keywords 
known as access modifiers. 

Let's modify our example to demonstrate this effect: 



dass Animal { 

public String name; 
public int legs; 


public void walk() { } 

} 


By declaring all fields and methods public, we have ensured that they can be used outside the scope of the Animal dass. This means that any other object (other than Animal) has 
access to these member elements. However, to restrict access to certain member elements of a dass, we can always use the private access modifier (as demonstrated below). 
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-, 

dass Animal { 1 

private String name; 1 

private int legs; 1 

public void walk() { }' 

} 1 


In this example, the fields name and legs can only be accessed within the scope of the Animal dass. No object outside the scope of this dass can access these two fidds. However, 
since the walk () method still has public access, it can be manipulated by actors and objects outside the scope of this dass. Access modifiers are not just limited to fields or 
methods, they can be used for dass definitions as well (as is demonstrated below). 


;-l 

ipublic dass Animal { 1 

i private String name; 1 

i private int legs; 1 

i public void walk() { }' 

!} ■ 


The following list of keywords show the valid access modifiers that can be used with a Java program: 


keyword 

description 

public 

Opens access to a certain field or method to be used outside the scope of the dass. 

private 

Restricts access to a certain field or method to only be used within the scope of the dass. 

protected 

Access to certain field or methods is reserved for classes that inherit the current dass. 

More on this would be discussed in the section on inheritance. 


Installation 


In order to make use of the content in this book, you would need to follow along each and every tutorial rather than simply reading through the book. But to do so, you would need 
access to a Computer with the Java platform installed on it — the Java platform is the basic prerequisite for running and developing Java code, thus it is divided into two essential 
pieces of Software: 

■ the Java Runtime Environment (JRE), which is needed to run Java applications and applets; and, 

■ the Java Development Kit (JDK), which is needed to develop those Java applications and applets. 

However as a developer, you would only require the JDK which comes equipped with a JRE as well. Given below are installation instruction for the JDK for various operating 
Systems: 

Installation instructions for Windows 


Availability check for JRE 

The Java Runtime Environment (JRE) is necessary to execute Java programs. To check which Version of Java Runtime Environment (JRE) you have, follow the Steps below. 

1. For Window Vista or Windows 7, click Start > Control Panel > System and Maintenance > System. 

For Windows XP, click Start > Control Panel > System. 

For Windows 2000, click Start > Settings > Control Panel > System. 

Alternatively, you can also press ffl Win + R to open the Run dialog. With the dialog open, type cmd at the prompt: 



2. In the command window with black background graced with white text, type the following command: 



DRE availability check 


ijava -Version 

l__ 


If you get an error, such as: 


□I 


Other output error 
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iBad command or file name 

I_ 


..then the JDK may not be installed or it may not be in your path. 


To learn more about the Command Prompt syntax, take a look at this MS-DOS tutorial (http://tnd.com/camosun/elexl 30/dostutor 1 .html). 

You may have other versions of Java installed; this command will only show the first in your PATH. You will be made familiär with the PATH environment variable later in this 
text. For now, if you have no idea what this is all about. Read through towards the end and we will provide you with a step-by-step guide on how to set your own environment 
variables. 

You can use your system's file search Utilities to see if there is a javac. exe executable installed. If it is, and it is a recent enough Version (Java 1.4.2 or Java 1.5, for example), 
you should put the bin directory that contains javac in your System path. The Java runtime, java, is often in the same bin directory. 

If the installed Version is older (i.e. it is Java 1.3.1 or Java 1.4.2 and you wish to use the more recent Java 5 release), you should proceed below with downloading and installing a 
JDK. 

It is possible that you have the Java runtime (JRE), but not the JDK. In that case the javac program won’t be found, but the java -version will print the JRE Version number. 


Availability check for JDK 


Some Windows based Systems come built-in with the JRE, however for the purposes of writing Java code by following the tutorials in this book, you would require the JDK 
nevertheless. The Java Development Kit (JDK) is necessary to build Java programs. First, check to see if a JDK is already installed on your System. To do so, first open a 
command window and execute the command below. 



Availability check 


ijavac -version 

l_ 


If the JDK is installed and on your executable path, you should see some output which teils you the command line options. The output will vary depending on which version is 
installed and which vendor provided the Java installation. 

Advanced availability check options on Windows platform 

On a machine using the Windows operating System, one can invoke the Registry Editor utility by typing regedit in the Run dialog. In the window that opens subsequently, if you 
traverse through the hierarchy hkey_local_machine > Software > JavaSoft > Java Development Kit on the left-hand. 

The resultant would be similar to figure 1.2, with the only exception being the version entries for the Java Development Kit. At the time of writing this manuscript, the latest 
version for the Java Development Kit available from the Internet was 1.7 as seen in the Registry entry. If you see a resultant window that resembles the one presented above, it 
would prove that you have Java installed on your System, otherwise it is not. 



Caution should be exercised when traversing through the Registry Editor. Any changes to the keys and other entries may change the way your Windows operating 
System normally works. Even minor changes may result into catastrophic failures of the normal working of your machine. Better that you don’t modify or tend to modify 
anything whilst you are in the Registry Editor. 


Download instructions 

To acquire the latest JDK (version 7), you can manually download the Java Software (http://www.oracle.com/technetwork/java/javase/downloads/index.html) from the Oracle 
website. 


For the convenience of our readers, the following table presents direct links to the latest JDK for the Windows operating System. 


Operating 

System 

Setup Installer 

License 

Windows x86 

Download (http://download.oracle.com/otn-pub/java/jdk 
/7ul-b08/jdk-7u l-windows-i586.exe) 

Oracle Binary Code License Agreement (http://www.oracle.com/technetwork 
/java/javasebusiness/documentation/java-se-bcl-license-430205.html) 

Windows x64 

Download (http://download.oracle.com/otn-pub/java/jdk 
/7u l-b08/jdk-7u l-windows-x64.exe) 

Oracle Binary Code License Agreement (http://www.oracle.com/technetwork 
/java/javasebusiness/documentation/java-se-bcl-license-430205.html) 


You must follow the instructions for the setup installer wizard step-by-step with the default settings to ensure that Java is properly installed on your System. Once the setup is 
completed, it is highly recommended to restart your Windows operating System. 

If you kept the default settings for the setup installer wizard, your JDK should now be installed at C:\Program Files\Java\jdkl.7.0_01. You would require the location to your 
bin folder at a later time — this is located at C: YProgram Files\Java\jdkl.7.0_01\bin It may be a hidden file, but no matter. Just don't use Program Files (x86)\ by mistake 
unless that’s were installed Java. 

Updating environment variables 
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In Order for you to Start using the JDK Compiler utility with the Command Prompt, you would need to set the environment variables that points to the bin folder of your recently 
installed JDK. To set permanently your environment variables, follow the Steps below. 


1. To open System Properties dialog box use, the Control Panel or type the following command in the command window: 


□I 


System properties 


irund!132 shel132.dl1,Control_RunDLL sysdm.cpl 


2. Navigate to the Advanced tab on the top, and select Environment Variables... 

3. Under System variables, select the variable named Path and click Edit... 

4. In the Edit System Variable dialog, go to the Variable value field. This field is a Hst of directory paths separated by semi-colons (;). 

5. To add a new path, append the location of your JDK bin folder separated by a semi-colon (;). 

6. Click OK on every opened dialog to save changes and get past to where you started. 


Start writing code 

Once you have successfully installed the JDK on your System, you are ready to program code in the Java programming language. However, to write code, you would need a 
decent text editor. Windows comes with a default text editor by default — Notepad. In Order to use notepad to write code in Java, you need to follow the steps below: 


1. Click Start > All Programs > Accessories > Notepad to invoke the application. 

Alternatively, you can also press ffl Win + R to open the Run dialog. With the dialog open, type the following command at the prompt: 


□i 


Notepad launching 


inotepad 

L_ 


2. Once the Notepad application has fired up, you can use the editor to write code for the Java programming language. 
Installation instructions for GNU/Linux 

Availability check for JRE 


The Java Runtime Environment (JRE) is necessary to execute Java programs. To check which Version of JRE you have, follow the steps below. 


1. Open the Terminal window. 

2. Type the following command: 



JRE availability check 


ijava -Version 

l_ 


If you get something like this: 



Output on a particular Kubuntu 12.10 installation 


-1 

java Version "1.7.0_09" 1 
OpenJDK Runtime Environment (IcedTea7 2.3.3) ( 7u9-2.3.3-0ubuntul~12.10.1) 1 
OpenJDK Client VM (build 23.2-b09, mixed mode, sharing) 1 


... then a JRE is installed. If you get an error, such as: 



Output error 


ijava: command not found 

l_ 


... then the JDK may not be installed or it may not be in your path. 


You may have other versions of Java installed; this command will only show the first in your PATH. You will be made fami li är with the PATH environment variable later in this 
text. For now, if you have no idea what this is all about, read through towards the end and we will provide you with a step-by-step guide on how to set your own environment 
variables. 

You can use your system's file search Utilities to see if there is a javac executable installed. If it is, and it is a recent enough Version, you should put the bin directory that 
contains javac in your System path. The Java runtime, java, is often in the same bin directory. 

If the installed Version is older (i.e. it is Java 5 and you wish to use the more recent Java 7 release), you should proceed below with downloading and installing a JDK. 

It is possible that you have the Java runtime (JRE), but not the JDK. In that case the javac program won’t be found, but the java -version will print the JRE Version number. 


Availability check for JDK 


The Java Development Kit (JDK) is necessary to build Java programs. For our purposes, you must use a JDK. First, check to see if a JDK is already installed on your System. To 
do so, first open a terminal window and execute the command below. 



Availability check 


ijavac -version 

l_ 
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If the JDK is installed and on your executable path, you should see some output which teils you the command line options. The output will vary depending on which Version is 
installed and which vendor provided the Java installation. 

Installation using Terminal 

Downloading and installing the Java platform on Linux machines (in particular Ubuntu Linux) is very easy and straight-forward. To use the terminal to download and install the 
Java platform, follow the instructions below. 


1. Open the Terminal window. 


2. At the prompt, write the following (your package manager may be other than APT, so change the command accordingly): 



Retrieving the java packages 


i$ sudo apt-get install openjdk-7-jdk openjdk-7-doc 

L_ 


3. All Java softwares should be installed and instantly available now. 


Download instructions 


Alternatively, you can manually download the Java Software (http://www.oracle.com/technetwork/java/javase/downloads/index.html) from the Oracle website. 


For the convenience of our readers, the following table presents direct links to the latest JDK for the Linux operating System. 


Operating 

System 

RPM 

Tarball 

License 

Linux x86 

Download (http ://download. oracle. c om 

/otn-pub/java/jdk/7u7-bl0/jdk-7u7-linux- 

i586.rpm) 

Download (http://download.oracle.com/otn-pub 
/java/jdk/7u 1 -b08/jdk-7u 1 -linux-i586.tar.gz) 

Oracle Binary Code License Agreement 
(http://www.oracle.com/technetwork/java/javasebusiness 
/documentation/java-se-bcl- license-430205.html) 

Linux x64 

Download (http://download.oracle.com 
/otn-pub/java/jdk/7u 1 -b08/jdk-7u 1 -linux- 
x64.rpm) 

Download (http://download.oracle.com/otn-pub 
/java/jdk/7u 1 -b08/jdk-7u 1 -linux-x64 .tar.gz) 

Oracle Binary Code License Agreement 
(http://www.oracle.com/technetwork/java/javasebusiness 
/documentation/java-se-bcl- license-430205.html) 


Start writing code 

The most widely available text editor on GNOME desktops is Gedit, while on the KDE desktops, one can find Kate. Both these editors support syntax highlighting and code 
completion and therefore are sufficient for our purposes. 

However, if you require a robust and standalone text-editor like the Notepad++ editor on Windows, you would require the use of the minimalistic editor loaded with features - 
SciTE. Follow the instructions below if you wish to install SciTE: 


1. Open the Terminal window. 

2. At the prompt, write the following: 


□I 


Retrieving the java packages 


i$ sudo apt-get install scite 

l__ 


3. You should now be able to use SciTE for your programming needs. You may also want to try Geany. Installation instructions are similar to those for SciTE. 

Installation instructions for Mac OS 

On Mac OS, both the JRE and the JDK are already installed. However, the Version installed was the latest Version when the Computer was purchased, so you may want to update 
it. 


Updating Java for Mac OS 


1. Go to the Java download page (http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html). 

2. Mechanically accept Oracle's license agreement. 

3. Click on the link for Mac OS X. 

4. Run the installer package. 

Availability check for JDK 


The Java Development Kit (JDK) is necessary to build Java programs. For our purposes, you must use a JDK. First, check to see if a JDK is already installed on your System. To 
do so, first open a terminal window and execute the command below. 



Availability check 


ijava -Version 

l _ 


If the JDK is installed and on your executable path, you should see some output which teils you the command line options. The output will vary depending on which Version is 
installed and which vendor provided the Java installation. 

Installation instructions for Solaris 
No Install Option for Programming Online 

If you already have the JRE installed, you can use the Java Wiki Integrated Development Environment (JavaWIDE) to code directly in your browser, no account or special 
Software required. 

Click here to visit the JavaWIDE Sandbox to get started. (http://sandbox.javawide.org) 
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For more information, click here to visit the JavaWIDE site. (http://www.javawide.org) 


Compilation 

In Java, programs are not compiled into executable files; they are compiled into bytecode (as discussed earlier), which the JVM (Java Virtual Machine) then executes at runtime. 
Java source code is compiled into bytecode when we use the javac Compiler. The bytecode gets saved on the disk with the file extension .dass. When the programis to be run, 
the bytecode is converted, using the just-in-time (JIT) Compiler. The result is machine code which is then fed to the memory and is executed. 

Java code needs to be compiled twice in order to be executed: 

1. Java programs need to be compiled to bytecode. 

2. When the bytecode is run, it needs to be converted to machine code. 

The Java classes/bytecode are compiled to machine code and loaded into memory by the JVM when needed the first time. This is different from other languages like C/C++ where 
programs are to be compiled to machine code and linked to create an executable file before it can be executed. 

Quick Compilation procedure 

To execute your first Java program, follow the instructions below: 


1. Proceed only if you have successfully installed and configured your System for Java as discussed here. 

2. Open your preferred text editor — this is the editor you set while installing the Java platform. 

For example, Notepad or Notepad++ on Windows; Gedit, Kate or SciTE on Linux; or, XCode on Mac OS, etc. 

3. Write the following lines of code in a new text document: 

Code listing 2.5: HelloWorld.java 


ipublic dass HelloWorld { 

i public static void main (String[] args) { 
i System. out . println ( " Hello World!"); 

! } 

!} 


4. Save the file as Hello World.java — the name of your file should be the same as the name of your dass definition and followed by the . java extension. This name is 
case-sensitive, which means you need to capitalize the precise letters that were capitalized in the name for the dass definition. 

5. Next, open your preferred command-line application. 

For example, Command Prompt on Windows; and, Terminal on Linux and Mac OS. 

6. In your command-line application, navigate to the directory where you just created your file. If you do not know how to do this, consider reading through our crash courses 
for command-line applications for Windows or Linux. 

7. Compile the Java source file using the following command which you can copy and paste in if you want: 

Compilation 


ijavac HelloWorld . java 1 


A If you obtain an error message hke error: cannot read: Hel loworid. java l error, your file is not in the current folder or it is badly spelled. Did you 
navigate to the program's location in the command prompt using the cd (change directory) command? 

If you obtain another message ending by l error or . . . errors, there may be a mistake in your code. Are you sure all words are spelled correctly and with the 
exact case as shown? Are there semicolons and brackets in the appropriate spot? Are you missing a quote? Usually, modern IDEs would try coloring the entire 
source as a quote in this case. 

If your Computer emits beeps, then you may have illegal characters in your HelloWorld. java. 

If no HelloWorld. dass file has been created in the same folder, then you've got an error. Are you launching the javac program correctly? 

8. Once the Compiler returns to the prompt, run the application using the following command: 

Execution 

i-1 

ijava HelloWorld 1 


A If you obtain an error message like Except ion in thread "main" java . lang . NoClassDefFoundError : HelloWorld, the HelloWorld. dass file is not in the 

current folder or it is badly spelled. 

If you obtain an error message like Except ion in thread "main" java. lang .NoSuchMethodError: main, your source file may have been badly written. 


9. The above command should result in your command-line application displaying the following result: 

Output 


Askfor help if the pro gram did not execute properly in the Discussion page for this chapter. 

Automatic Compilation of Dependent Classes 
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In Java, if you have used any reference to any other java object, then the dass for that object will be automatically compiled, if that was not compiled already. These automatic 
compilations are nested, and this continues until all classes are compiled that are needed to run the program. So it is usually enough to compile only the high level dass, since all the 
dependent classes will be automatically compiled. 


Main dass Compilation 


I 


ijavac ... MainClass . java 

l_ 


However, you can’t rely on this feature if your program is using reflection to create objects, or you are compiling for servlets or for a "jar", package. In these cases you should list 
these classes for explicit Compilation. 

Main dass Compilation 


ijavac ... MainClass.java ServletOne.java . 

l- 



Packages, Subdirectories, and Resources 

Each Java top level dass belongs to a package (covered in the chapter about Packages). This may be declared in a package Statement at the beginning of the file; if that is missing, 
the dass belongs to the unnamed package. 

For Compilation, the file must be in the right directory structure. A file containing a dass in the unnamed package must be in the current/root directory; if the dass belongs to a 
package, it must be in a directory with the same name as the package. 

The Convention is that package names and directory names corresponding to the package consist of only lower case letters. 

Top level package 

A dass with this package declaration 


m 


Code section 2.1: Package declaration 

1 -1 

Jpackage example; i 


has to be in a directory named example. 


Subpackages 


A dass with this package declaration 


m 


Code section 2.2: Package declaration with sub-packages 


•package org.wikibooks.en; 

I-- 


has to be in a directory named en which has to be a sub-directory of wikibooks which in turn has to be a sub-directory of org resulting in org/wikibooks/en on Linux or 

org\wikibooks\en on Windows. 

Java programs often contain non-code files such as images and properties files. These are referred to generally as resources and stored in directories local to the classes in which 
they’re used. For example, if the dass com. example. ExampieApp uses the icon. png file, this file could be stored as / com/example/resources / icon. png. These resources 
present a problem when a program is complied, because javac does not copy them to wherever the .dass files are being complied to (see above); it is up to the programmer to 
move the resource files and directories. 

Filename Case 

The Java source file name must be the same as the public dass name that the file contains. There can be only one public dass defined per file. The Java dass name is case sensitive, 
as is the source file name. 

The naming Convention for the dass name is for it to Start with a Capital letter. 

Compiler Options 

Debugging and Symbolic Information 

Ant 


For comprehensive Information about all aspects of Ant, please see the Ant Wikibook. 

The best way to build your application is to use a build tool. This checks all the needed dependencies and compiles only the needed dass for the build. Ant tool is one of the best 
and the most populär build tools currently available. Ant is a build management tool designed to replace MAKE as the tool for automated builds of large Java applications. Like 
Java, and unlike MAKE, Ant is designed to be platform independent. 

Using Ant you would build your application from the command line by typing: 

Ant building 


iant build. xml 

l- 


The build. xml file contains all the information needed to build the application. 
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Building a Java application requires certain tasks to be performed defined in a build. xmi file. Those tasks may include not only compiling the Code, but also copying code, 
packaging the program to a Jar, creating EJBs, running automated tests, doing ftp for the code to remote site, and so on. For some tasks a condition can be assigned, for example to 
compile only changed code, or do the task if that was not already done so. Tasks dependency can also be specified, which will make sure that the Order of executions of the tasks 
are in the right order. For example, when compiling the code before packaging it to a jar, the package-to-jar task depends on the Compilation task. 

In rare cases, your code may appear to compile correctly but the program behaves as if you were using an old copy of the source code (or otherwise reports errors during 
runtime.) When this occurs, you may need to clean your Compilation folder by either deleting the dass files or using the Clean command from an IDE. 

The build. xmi file is generally kept in the root directory of the java project. Ant parses this file and executes the tasks therein. Below we give an example build. xmi file. 

Ant tool is written in Java and is open source, so it can be extended if there is a task you’d like to be done during the build that is not in the predefined tasks list. It is very easy to 
hook your ant task code to the other tasks: your code only needs to be in the classpath, and the Ant tool will load it at runtime. For more information about writing your own Ant 
tasks, please see the project website at http://ant.apache.org/. 



Example build.xmi file. 


The next most populär way to build applications is using an Integrated Development Environment (IDE). 

The JIT Compiler 

The Just-In-Time (JIT) Compiler is the Compiler that converts the byte-code to machine code. It compiles byte-code once and the compiled machine code is re-used again and again, 
to speed up execution. Early Java Compilers compiled the byte-code to machine code each time it was used, but more modern Compilers cache this machine code for reuse on the 
machine. Even then, java's JIT compiling was still faster than an "interpreter-language", where code is compiled from high level language, instead of from byte-code each time it 
was used. 

The Standard JIT Compiler runs on demand. When a method is called repeatedly, the JIT Compiler analyzes the bytecode and produces highly efficient machine code, which runs 
very fast. The JIT Compiler is smart enough to recognize when the code has already been compiled, so as the application runs, Compilation happens only as needed. As Java 
applications run, they tend to become faster and faster, because the JIT can perform runtime profiling and optimization to the code to meet the execution environment. Methods or 
code blocks which do not run often receive less optimization; those which run often (so called hotspots ) receive more profiling and optimization. 


Execution 

There are various ways in which Java code can be executed. A complex Java application usually uses third party APIs or Services. In this section we list the most populär ways a 
piece of Java code may be packed together and/or executed. 

JSE code execution 

Java language first edition came out in the client-server era. Thick clients were developed with rieh GUI interfaces. Java first edition, JSE (Java Standard Edition) had/has the 
following in its beit: 

■ GUI capabilities (AWT, Swing) 

■ Network computing capabilities (RMI) 

■ Multi-tasking capabilities (Threads) 

With JSE the following Java code executions are possible: 

Stand alone Java application 

(Figure 1) Stand alone application refers to a Java program where both the user interface and business modules are running on the same 
Computer. The application may or may not use a database to persist data. The user interface could be either AWT or Swing. 

The application would Start with a main () method of a Class. The application stops when the main () method exits, or if an exception is 
thrown from the application to the JVM. Classes are loaded to memory and compiled as needed, either from the file System or from a *.jar 
file, by the JVM. 

Invocation of Java programs distributed in this manner requires usage of the command line. Once the user has all the class files, he needs to 
launch the application by the following command line (where Main is the name of the class containing the main() method.) 

Execution of class 


ijava Main 


«Computer» 

0JVM 

Java Application 


Data base 


Figure 1: Stand alone execution 


Java 'jar' class libraries 

Utility classes, framework classes, and/or third party classes are usually packaged and distributed in Java ' *.jar' files. These jar' files need to be put in the CLASSPATH of the 
java program from which these classes are going to be used. 

If a jar file is executable, it can be run from the command line: 



Execution of archive 




ijava -jar Application . jar 1 

i_! 


Java Applet code 

(Figure 2) Java Applets are Java code referenced from HTML pages, by the <APPLET> tag. The Java code is downloaded from a Server and runs in the dient browser JVM. 
Java has built-in support to render applets in the browser window. 

Sophisticated GUI clients were found hard to develop, mostly because of download time, incompatibilities between browser JVM implementations, and communication 
requirements back to the Server. Applets are rarely used today, and are most commonly used as small, separate graphic-like animation applets. The popularity of Java declined 
when Microsoft withdrew its Java support from Internet Explorer default configuration, however, the plugin is still available as a free download fromjava.com 
(http://java.com/). 

More information can be found about applets at the Applet Chapter, in this book. Also, Wikipedia has an article about Java Applets. 

Client Server applications 
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The dient Server applications consist of a front-end, and a back-end part, both running on a separate Computer. The idea is that 
the business logic would be on the back-end part of the program, which would be reused by all the cbents. Here the challenge is to 
achieve a Separation between front-end user interface code, and the back-end business logic code. 

The communication between the front-end and the back-end can be achieved by two ways. 

■ One way is to define a data communication protocol between the two tiers. The back-end part would listen for an 
incoming request. Based on the protocol it interprets the request and sends back the result in data form. 

■ The other way is to use Java Remote Invocation (RMI). With the use of RMI, a remote object can be created and 
used by the client. In this case Java objects are transmitted across the network. 

More information can be found about client-server programming, with sample code, at the Client Server Chapter in this book. 

Web Applications 

For applications needed by lots of client installations, the client-server model did not work. Maintaining and upgrading the 
hundreds or thousands of clients caused a problem. It was not practical. The solution to this problem was to create a unified, Standard client, for all applications, and that is the 
Browser. 

Having a Standard client, it makes sense to create a unified, Standard back-end Service as well, and that is the Application Server. 

Web Application is an application that is running in the Application Server, and it can be accessed and used by the Browser client. 

There are three main area of interest in Web Applications, those are: 

■ The Web Browser. This is the Container of rendering HTML text, and running client Scripts 

■ The HTTP protocol. Text data are sent back and forth between Browser and the Server 

■ The Web Server to serve static content, Application Server to serve dynamic content and host EJBs. 

Wikipedia also has an article about Web application. 

J2EE code execution 


«Ctent Computer» 

(v i Browser 

<html> 

<APPLET 

name="Heflo" 

corfcbase"'.," 

</APPLET> 

</html> 


«Server Compu... 

Application 

Server 


Data base 


Figure 2: Applet Execution 


As the focus was shifting from reaching GUI clients to thin client applications, with Java Version 2, Sun introduced J2EE (Java 2 Extended Edition). J2EE added : 

■ Components Base Architecture, (Servlet, JSP, EJB Containers) 

With J2EE the following Java component executions are possible: 

Java Servlet code 

(Figure 3) Java got its popularity with Server side programming, more specifically with J2EE servlets. Servlets are running in a 
simple J2EE framework to handle client HTTP requests. They are meant to replace CGI programming for web pages rendering 
dynamic content. 

The servlet is running in a so called servlet-container/web Container. The servlet’s responsibility is to: 

■ Handle the request by doing the business logic computation, 

■ Connecting to a database if needed, 

■ Create HTML to present to the user through the browser 

The HTML output represents both the presention logic and the results of the business computations. This represents a huge 

problem, and there is no real application relying only on servlets to handle the presention part of the responsibility. There are two main Solutions to this: 

■ Use a template tool (Store the presentation part in an HTML file, marking the areas that need to be replaced after business logic computations). 

■ Use JSP (See next section) 

Wikipedia also has an article about Servlets. 

Java Server Pages (JSP) code 

(Figure 4) JSP is an HTML file with embedded Java code inside. The first time the JSP is accessed, the JSP is converted to a Java 
Servlet. This servlet Outputs HTML which has inside the result of the business logic computation. There are special JSP tags that 
helps to add data dynamically to the HTML. Also JSP technology allows to create custom tags. 

Using the JSP technology correctly, business logic computations should not be in the embedded Java part of the JSP. JSP should be 
used to render the presentation of the static and dynamic data. Depending on the complexity of the data, 100% Separation is not 
easy to achieve. Using custom tags, however may help to get closer to 100%. This is advocated also in MVC architecture (see 
below). 
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EJB code 

(Figure 5) In the 1990s, with the client Server computing, a trend started, that is to move away from Mainframe 
Computing. That resulted in many small separate applications in a Company/Enterprise. Many times the same data was 
used in different applications. A new philosophy, "Enterprise Computing", was created to address these issues. The idea 
was to create components that can be reused throughout the Enterprise. The Enterprise Java Beans (EJBs) were supposed 
to address this. 

An EJB is an application component that runs in an EJB Container. The client accesses the EJB modules through the 
Container, never directly. The Container manages the life cycle of the EJB modules, and handles all the issues that arise 
from network/enterpise computing. Some of those are security/access control, object pooling, transaction management,... 

EJBs have the same problems as any reusable code: they need to be generic enough to be able to be reused and the 
changes or maintenance of EJBs can affect existing clients. Many times EJBs are used unnecessarily when they are not 
really needed. An EJB should be designed as a separate application in the enterprise, fulfilling one function. 
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Figure 5: EJB Execution 


Combine J2EE components to create an MVC architecture 

This leads us to the three layers/tiers as shown in (Figure 6). 

In modern web applications, with lots of static data and nice graphics, how the data is presented to the user 
became very important and usually needs the help of a graphic artist. 

To help programmers and graphic artists to work together, the Separation between data, code, and how it is 
presented became crucial. 

■ The view (User Interface Logic) contains the logic that is necessary to construct the presentation. This could 
be handled by JSP technology. 

■ The servlet acts as the Controller and contains the logic that is necessary to process user events and to 
select an appropriate response. 

■ The business logic (model) actually accomplishes the goal of the interaction. This might be a query or an 
update to a database. This could be handled by EJB technology. 

For more information about MVC, please see MVC. 



Jini 

After J2EE Sun had a vision about the next Step of network computing. That is Jini. The main idea is that in a network environment, there would be many independent Services and 
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consumers. Jini would allow these services/consumers to interact dynamically with each other in a robust way. The basic features of Jini are: 

■ No user intervention is needed when Services are brought on or offline. (In contrast to EJBs where the client program has to know the Server and port number where the EJB 
is deployed, in Jini the client is supposed to find, to discover, the Service in the network.) 

■ Seif healing by adapting when Services (consumers of Services) come and go. (Services periodically need to renew a lease to indicate that they are still available.) 

■ Consumers of JINI Services do not need prior knowledge of the service's implementation. The implementation is downloaded dynamically and run on the consumer JVM, 
without configuration and user intervention. (For example, the end user may be presented with a slightly different user interface depending upon which Service is being used 
at the time. The implementation of the user interface Code would be provided by the Service being used.) 

A minimal Jini network environment consists of: 

■ One or more Services 

■ A lookup-service keeping a list of registered Services 

■ One or more consumers 

Jini is not widely used at the current writing (2006). There are two possible reasons for it. One is Jini a bit complicated to understand and to set it up. The other reason is that 
Microsoft pulled out from Java, which caused the industry to turn to the use of proprietary Solutions. 


Understanding a Java Program 

This article presents a small Java program which can be run from the console. It computes the distance between two points on a plane. You do not need to understand the structure 
and meaning of the program just yet; we will get to that soon. Also, because the program is intended as a simple introduction, it has some room for improvement, and later in the 
module we will show some of these improvements. But let's not get too far ahead of ourselves! 

The Distance Class: Intent, Source, and Use 

This class is named Distance, so using your favorite editor or Java IDE, first create a file named Distance. java, then copy the source below, paste it into the file and save the file. 

Code listing 2.1: Distance.java 


1 public class Distance { 

2 private j ava. awt . Point pointO, pointl; 

3 

4 public Distance (int xO, int yO, int xl, int yl) { 

5 pointO = new java. awt .Point (xO, yO); 

6 pointl = new java. awt .Point (xl, yl); 

7 } 

8 

9 public void printDistance () { 

10 System.out .printin ( "Distance between " + pointO + " and " + pointl 

11 + " is " + pointO. distance (pointl)); 

12 } 

13 

14 public static void main (String[] args) { 

15 Distance dist = new Distance( 

16 intValue(args[0]) , intValue(args[1]), 

17 intValue(args[2]) , intValue(args[3])); 

18 dist. printDistance (); 

19 } 

20 

21 private static int intValue (String data) { 

22 return Integer .parseint (data); 

23 } 

24 } 


At this point, you may wish to review the source to see how much you might be able to understand. While perhaps not being the most literate of programming languages, someone 
with understanding of other procedural languages such as C, or other object oriented languages such as C++ or C#, will be able to understand most if not all of the sample program. 

Once you save the file, compile the program: 

Compilation command 

J-1 

i$ javac Distance . java 1 


(If the javac command fails, review the installation instructions.) 

To run the program, you supply it with the x and y Coordinates of two points on a plane separated by a space. For this Version of Distance, only integer points are supported. The 
command sequence is java Distance <x 0 > <yo> <^i> <yi> to compute the distance between the points (xq, yo ) and ( xj, yj). 


/jV I If you get a java. lang. NumberFormatExcept ion exception, some arguments are not a number. If you get a java. lang. Array indexOutof BoundsExcept ion exception, 
| you did not provide enough numbers. 

Here are two example s: 


Output for the distance between the points 3) and (4., 0) 

---------------------------------------------------------------- 

i 

i$ java Distance 0 3 4 0 

i 

iDistance between java.awt.Point[x=0,y=3] and java.awt.Point[x=4,y=0] is 5.0 

i 

I_! 


Output for the distance between the points (-4., 5) and (11., 19) 

l-I 

|$ java Distance -4 5 11 19 1 
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iDistance between java.awt.Point[x=-4,y=5] and java.awt.Point[x=ll / y=19] is 20.518284528683193i 

l-1 


We'll explain this stränge looking output, and also show how to improve it, later. 

Detailed Program Structure and OverView 

As promised, we will now provide a detailed description of this Java program. We will discuss the syntax and structure of the program and the meaning of that structure. 

Introduction to Java Syntax 


i-1 

■public dass Distance { ■ 

, private java.awt.Point pointO, pointl; , 

i public Distance (int xO, int yO, int xl, int yl) { i 

1 pointO = new java.awt.Point(xO, yO); 1 

i pointl = new j ava.awt.Point(xl, yl); i 

! > ! 


public void printDistance() { 

System.out.println( " Distance between " + pointO + " and " 
+ " is " + pointO.distance(pointl)); 


} 


+ pointl 


public static void main(String[] args) { 

Distance dist = new Distance( 

intValue(args[0]), intValue(args[1]), 
intValue(args[2]), intValue(args[ 3 ])); 
dist.printDistance(); 

} 


private static int intValue(String data) { 
return Integer.parseint(data); 

} 


L 


-I 


Figure 2.1: Basic Java syntax. 

For afurther treatment of the syntax elements of Java, see also Syntax. 

The syntax of a Java dass is the characters, Symbols and their structure used to Code the dass. Java programs consist of a sequence of tokens. There are different kinds of tokens. 
For example, there are word tokens such as dass and public which represent keywords (in purple above) — special words with reserved meaning in Java. Other words such as 
Distance, pointO, xl, and printDistance are not keywords but identifiers (in grey). Identifiers have many different uses in Java but primarily they are used as names. Java also 
has tokens to represent numbers, such as l and 3; these are known as literals (in orange). String literals (in blue), such as "Distance between ", consist of zero or more 
characters embedded in double quotes, and operators (in red) such as + and = are used to express basic computation such as addition or String concatenation or assignment. There 
are also left and right braces ({ and }) which enclose blocks. The body of a dass is one such block. Some tokens are punctuation, such as periods . and commas , and semicolons ; 
You use whitespace such as spaces, tabs, and newlines, to separate tokens. For example, whitespace is required between keywords and identifiers: publicstatic is a single 
identifier with twelve characters, not two Java keywords. 

Declarations and Definitions 
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private static int intValue(String data) { 
return Integer.parseint(data); 

} 


Figure 2.2: Declarations and Definitions. 

Sequences of tokens are used to construct the next building blocks of Java classes as shown above: declarations and definitions. A dass declaration provides the name and visibility 
of a dass. In our example, public dass Distance is the dass declaration. It consists (in this case) of two keywords, public and dass followed by the identifier Distance. 

This means that we are defining a dass named Distance. Other classes, or in our case, the command line, can refer to the dass by this name. The public keyword is an access 
modifier which declares that this dass and its members may be accessed from other classes. The dass keyword, obviously, identifies this declaration as a dass. Java also allows 
declarations of interfaces and annotations. 

The dass declaration is then followed by a block (surrounded by curly braces) which provides the class's definition (in blue in figure 2.2). The definition is the implementation of the 
dass - the declaration and definitions of the class's members. This dass contains exactly six members, which we will explain in turn. 

1. Two field declarations, named point o and point l (in green) 

2. A constructor declaration (in orange) 

3. Three method declarations (in red) 

Example: Instance Fields 

The declaration 

Code section 2.1: Declaration. 

• -, 

■1 private j ava . awt . Point pointO, pointl;i 

i-1 



...declares two instance fields. Instance fields represent named values that are allocated whenever an instance of the dass is constructed. When a Java program creates a Distance 
instance, that instance will contain space for pointo and pointi. When another Distance object is created, it will contain space for its own pointo and pointi values. The value 
of pointo in the first Distance object can vary independently of the value of pointo in the second Distance object. 

This declaration consists of: 

1. The private access modifier, 

which means these instance fields are not visible to other classes. 

2. The type of the instance fields. In this case, the type is java. awt .Point. 

This is the dass Point in the java. awt package. 

3. The names of the instance fields in a comma separated list. 


These two fields could also have been declared with two separate but more verbose declarations, 



Code section 2.2: Verbose declarations. 

;-i 


,1 private j ava. awt . Point pointO; 
■2 private j ava . awt . Point pointi; 

L_ 


Since the type of these fields is a reference type (i.e. a field that refers to or can hold a reference to an object value), Java will implicitly initialize the values of pointo and pointi 
to null when a Distance instance is created. The null value means that a reference value does not refer to an object. The special Java literal null is used to represent the null value 
in a program. While you can explicitly assign null values in a declaration, as in 


i^jP Code section 2.3: Declarations and assignments. 

;- 1 

[l private java. awt . Point pointO = null; i 

■2 private j ava . awt . Point pointi = null; , 


It is not necessary and most programmers omit such default assignments. 

Example: Constructor 

A constructor is a special method in a dass which is used to construct an instance of the dass. The constructor can perform initialization for the object, beyond that which the Java 
VM does automatically. For example, Java will automatically initialize the fields pointo and pointi to null. 

Code section 2.4: The constructor for the dass 


[1 public Distance (int xO, int yO, int xl, int yl) { 
i2 pointO = new java . awt . Point (xO , yO); 

,3 pointi = new java. awt . Point (xl, yl); 

|4 } 



The constructor above consists of five parts: 

1. The optional access modifier(s). 

In this case, the constructor is declared public 

2. The constructor name, which must match the dass name exactly: Distance in this case. 

3. The constructor parameters. 

The parameter list is required. Even if a constructor does not have any parameters, you must specify the empty list (). The parameter list declares the type and name of each 
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of the method’s parameters. 

4. An optional throws clause which declares the exceptions that the constructor may throw. This constructor does not declare any exceptions. 

5. The constructor body, which is a Java block (enclosed in {}). This constructor's body contains two Statements. 

This constructor accepts four parameters, named xo, yO, xi and yi. Each parameter requires a parameter type declaration, which in this example is int for all four parameters. 
The parameters in the parameter list are separated by commas. 

The two assignments in this constructor use Java’s new operator to allocate two java. awt .Point objects. The first allocates an object representing the first point, (xo , yO ), and 
assigns it to the pointo instance variable (replacing the null value that the instance variable was initialized to). The second Statement allocates a second java. awt. Point instance 
with (xi, yi) and assigns it to the pointi instance variable. 

This is the constructor for the Distance dass. Distance implicitly extends from java. lang. object. Java inserts a call to the super constructor as the first executable Statement of 
the constructor if there is not one explicitly coded. The above constructor body is equivalent to the following body with the explicit super constructor call: 

Code section 2.5: Super constructor. 


.i { 

[2 super () ; 

■3 pointO = new java. awt . Point (xO , yO); 

,4 pointi = new java. awt . Point (xl, yl); 

|5 } 

L_- 



W hile it is true that this dass cou ld be implemented in other ways, such as simply storing the Coordinates of the two points and computing the distance as 

— j'o) 2 + {y [ ~ y 0 ) 2 ’ dass instead uses the existing java. awt .Point dass. This choice matches the abstract definition of this dass: to print the distance between 

two points on the plane. We take advantage of existing behavior already implemented in the Java platform rather than implementing it again. We will see later how to make the 
program more flexible without adding much complexity, because we choose to use object abstractions here. However, the key point is that this dass uses information hiding. That is, 
how the dass Stores its state or how it computes the distance is hidden. We can change this implementation without altering how clients use and invoke the dass. 

Example: Methods 

Methods are the third and most important type of dass member. This dass contains three methods in which the behavior of the Distance dass is defined: printDistance (), 
main (), and intValue () 


The printDistance() method 

The printDistance () method prints the distance between the two points to the Standard output (normally the console). 


Code section 2.6: printDistance () method. 


!i 

[2 

i3 

[4 

[5 


I 

public void printDistance () { 

System. out . print ln ( "Distance between " + pointO 
+ " and " + pointi 

+ " is " + pointO.distance(pointi)) ; 

} : 



This instance method executes within the context of an implicit Distance object. The instance field references, pointO and pointi, refer to instance fields of that implicit object. 
You can also use the special variable this to explicitly reference the current object. Within an instance method, Java binds the name this to the object on which the method is 
executing, and the type of this is that of the current dass. The body of the printDistance method could also be coded as 

Code section 2.7: Explicit instance of the current dass. 

1 - 1 

il System. out . printin ( "Distance between " + this.pointOi 
[2 + " and " + this. pointi [ 

■3 + " is " + this . point0 . distance (this . point1 )); 1 

l_i 



to make the instance field references more explicit. 

This method both computes the distance and prints it in one Statement. The distance is computed with pointO . distance (pointi); distance () is an instance method of the 
java. awt .Point dass (of which pointO and pointi are instances). The method operates on pointO (binding this to the object that pointO refers to during the execution of the 
method) and accepting another Point as a parameter. Actually, it is slightly more complicated than that, but we'll explain later. The result of the distance () method is a double 
precision floating point number. 

This method uses the syntax 



Code section 2.8: String concatenation. 

i-1 


il "Distance between " + this. pointO i 
[2 + " and " + this. pointi [ 
■3 + " is " + this . point0 . distance (this . point1 ) 1 

1 _ 1 


to construct a String to pass to the System, out .println (). This expression is a series of String concatenation methods which concatenates Strings or the String representation of 
primitive types (such as doubles) or objects, and returns a long string. For example, the result of this expression for the points (0,3) and (4,0) is the String 


Output 


j- 1 

i"Distance between java.awt.Point[x=0,y=3] and java.awt.Point[x=4,y=0] is 5.0 M| 

1 _! 


which the method then prints to System, out. 

In order to print, we invoke the print ln (). This is an instance method from java. io. Print stream, which is the type of the static field out in the dass java. lang. System. The 
Java VM binds System, out to the Standard output stream when it Starts a program. 

The main() method 
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The main () method is the main entry point which Java invokes when you Start a Java program from the command line. The command 

Output 

ijava Distance 0 3 4 


i 

o; 


instructs Java to locate the Distance dass, put the four command line arguments into an array of String values, then pass those arguments to the public static main (String [ ]) 
method of the dass. We will introduce arrays shortly. Any Java dass that you want to invoke from the command line or desktop shortcut must have a main method with this 
signature or the following signature: public static main (String. . .). 

Code section 2.9: main o method. 

I-1 

■1 public static void main ( String [] args) { i 

i2 Distance dist = new Distance ( , 

[3 intValue(args[0]), intValue(args[1]), 1 

■4 intValue(args[2]), intValue(args[3]))g 

[5 dist . pr intDistance () ; 1 

■6 } 1 



The main () method invokes the final method, intValue (), four times. The intValue () takes a single string parameter and returns the integer value represented in the string. For 
example, intValue (" 3") will return the integer 3. 

People who do test-first programming or perform regression testing write a main() method in every Java dass, and a main() function in every Python module, to run automated tests. 
When a person executes the file directly, the main() method executes and runs the automated tests for that file. When a person executes some other Java file that in turn imports 
many other Java classes, only one main() method is executed — the main() method of the directly-executed file. 

The intValue () method 

The intValue () method delegates its job to the integer .parseint o method. The main method could have called integer.parseint () directly; the intValue () method simply 
makes the main () method slightly more readable. 

Code section 2.10: intValue () method. 

i-1 

il private static int intValue ( String data) {■ 

[2 return Integer. parseint (data) ; ' 

■3 } 1 

1_1 



This method is private since, like the fields point 0 and point 1, it is part of the internal implementation of the dass and is not part of the external programming interface of the 
Distance dass. 


Static vs. Instance Methods 

Both the main () and intValue () methods are static methods. The static keyword teils the Compiler to create a single memory space associated with the dass. Each individual 
object instantiated has its own private state variables and methods but use the same static methods and members common to the single dass object created by the Compiler when 
the first dass object is instantiated or created. This means that the method executes in a static or non-object context — there is no implicit separate instance available when the 
static methods run from various objects, and the special variable this is not available. As such, static methods cannot access instance methods or instance fields (such as 
printDistance ()) or point o) directly. The main () method can only invoke the instance method printDistance () method via an instance reference such as dist. 

Data Types 

Most declarations have a data type. Java has several categories of data types: reference types, primitive types, array types, and a special type, void. 

Primitive Types 

The primitive types are used to represent boolean, character, and numeric values. This program uses only one primitive type explicitly, int, which represents 32 bit signed integer 
values. The program also implicitly uses double, which is the return type of the distance () method of java. awt. Point, double values are 64 bit IEEE floating point values. The 
main () method uses integer values 0, 1, 2, and 3 to access elements of the command line arguments. The Distance () constructor's four parameters also have the type int. Also, 
the intValue () method has a return type of int. This means a call to that method, such as intValue (args [ 0 ]), is an expression of type int. This helps explain why the main 
method cannot call: 

A Code section 2.11: Wrong type. 

• -, 

■1 new Distance(args[0], args[1], args[2], args[3]) // This is an erron 

I-1 


Since the type of the args array element is String, and our constructor's parameters must be int, such a call would result in an error because Java will not automatically convert 
values of type String into int values. 

Java's primitive types are boolean, byte, char, short, int, long, float and double. Each of which are also Java language keywords. 

Reference Types 

In addition to primitive types, Java supports reference type. A reference type is a Java data type which is defined by a Java dass or interface. Reference types derive this name 
because such values refer to an object or contain a reference to an object. The idea is similar to pointers in other languages like C. 

Java represents sequences of character data, or String, with the reference type java. lang, string which is most commonly referred to as string. String literals, such as 
"Distance between " are constants whose type is String. 

This program uses three separate reference types: 

1. java.lang.String (or simply String) 

2. Distance 

3. java.awt.Point 
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For more Information see chapter: Java Programming/Classes, Objects and Types. 

Array Types 

Java supports arrays, which are aggregate types which have a fixed element type (which can be any Java type) and an integral size. This program uses only one array, string [ ] 
args. This indicates that args has an array type and that the element type is string. The Java VM constructs and initializes the array that is passed to the main method. See arrays 
for more details on how to create arrays and access their size. 

The elements of arrays are accessed with integer indices. The first element of an array is always element 0. This program accesses the first four elements of the args array explicitly 
with the indices 0, 1,2, and 3. This program does not perform any input validation, such as verifying that the user passed at least four arguments to the program. We will fix that 
later. 

void 


void is not a type in Java; it represents the absence of a type. Methods which do not return values are declared as void methods. 
This dass defines two void methods: 



Code section 2.12: Void methods 
- - n 


,1 public static void main (St ring [ ] args) { ... } 

|2 public void printDistance () { ... } 

L- 


Whitespace 

Whitespace in Java is used to separate the tokens in a Java source file. Whitespace is required in some places, such as between access modifiers, type names and Identifiers, and is 
used to improve readability elsewhere. 

Wherever whitespace is required in Java, one or more whitespace characters may be used. Wherever whitespace is optional in Java, zero or more whitespace characters may be 
used. 

Java whitespace consists of the 

■ space character ' ' (0x20), 

■ the tab character (hex 0x09), 

■ the form feed character (hex 0x0c), 

■ the line Separators characters newline (hex 0x0a) or carriage return (hex OxOd) characters. 

Line Separators are special whitespace characters in that they also terminate line comments, whereas normal whitespace does not. 

Other Unicode space characters, including vertical tab, are not allowed as whitespace in Java. 

Required Whitespace 

Look at the static method intvalue: 

Code section 2.13: Method declaration 

i-1 

il private static int intValue (String data) {■ 

[2 return Integer .parseint (data); [ 

| 3 } 1 

1_1 



Whitespace is required between private and static, between static and int, between int and intvalue, and between string and data. 
If the code is written like this: 



Code section 2.14: Collapsed code 

1-1 


il privatestaticint intvalue (String data) { 
,2 return Integer .parseint (data); 

| 3 } 


L 


_l 


...it means something completely different: it declares a method which has the return type privatestaticint It is unlikely that this type exists and the method is no longer static, so 
the above would result in a semantic error. 

Indentation 

Java ignores all whitespace in front of a Statement. As this, these two code snippets are identical for the Compiler: 




m 


Code section 2.15: Indented code 


1 public static void main(String[] args) { 


Distance dist = new Distance( 

intValue(args[0] ) , intValue(args[1] ) , 
intValue(args[2]), intValue(args[3])); 

dist.printDistance(); 


} 


private static int intvalue (String data) { 
return Integer. parseint (data); 


10 } 


Code section 2.16: Not indented code 


1 public static void main (String[] args) { 

2 Distance dist = new Distance( 

3 intValue(args[0]), intValue(args[1]), 
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4 intValue(args[2] ) , intValue(args [3] ) ) ; 

5 dist. printDistance (); 

6 } 

7 

8 private static int intValue (String data) { 

9 return Integer. parseint (data); 

10 } 


However, the first one's style (with whitespace) is preferred, as the readability is higher. The method body is easier to distinguish from the head, even at a higher reading speed. 


Java IDEs 


What is a Java IDE? 


A Java IDE (Integrated Development Environment) is a Software application which enables users to more easily write and debug Java programs. Many IDEs provide features like 
syntax highlighting and Code completion, which help the user to code more easily. 


Eclipse 


Eclipse is a Free and Open Source IDE, plus a developer tool framework that can be extended for a particular development need. IBM was 
behind its development, and it replaced IBM VisualAge tool. The idea was to create a Standard look and feel that can be extended via plugins. 
The extensibility distinguishes Eclipse from other IDEs. Eclipse was also meant to compete with Microsoft Visual Studio tools. Microsoft tools 
give a Standard way of developing code in the Microsoft world. Eclipse gives a similar Standard way of developing code in the Java world, with 
a big success so far. With the online error checking only, coding can be sped up by at least 50% (coding does not include programming). 

The goals for Eclipse are twofold: 

1. Give a Standard IDE for developing code 

2. Give a starting point, and the same look and feel for all other more sophisticated tools built on Eclipse 
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Eclipse on Ubuntu 


IBM’s WSAD, and later IBM Rational Software Development Platform, are built on Eclipse. 


Standard Eclipse features: 


■ Standard window management (perspectives, views, browsers, explorers,...) 

■ Error checking as you type (immediate error indications,...) 

■ Help window as you type (type ., or <ctri> space,...) 

■ Automatic build (changes in source code are automatically compiled,...) 

■ Built-in debugger (full featured GUI debugger) 

■ Source code generation (getters and setters,...) 

■ Searches (for implementation, for references,...) 

■ Code refactoring (global reference update,...) 

■ Plugin-based architecture (ability to build tools that integrate seamlessly with the environment, and some other tools) 


More info: Eclipse (http://www.eclipse.org/) and Plugincentral (http://www.eclipseplugincentral.com/). 


NetBeans 


The NetBeans IDE is a Free and Open Source IDE for Software developers. The IDE runs on many platforms including Windows, GNU/Linux, 
Solaris and Mac OS X. It is easy to install and use straight out of the box. You can easily create Java applications for mobile devices using 
Mobility Pack in NetBeans. With Netbeans 6.0, the IDE has become one of the most preferred development tools, whether it be designing a 
Swing UI, building a mobile application, an enterprise application or using it as a platform for creating your own IDE. 

More info: netbeans.org (http://www.netbeans.org/products/ide/) 




MMIi • 


NetBeans on GNU/Linux 


JCreator 

JCreator is a simple and lightweight JAVA IDE from XINOX Software. It runs only on Windows platforms. It is very easy to install and Starts quickly, as it is a native application. 
This is a good choice for beginners. 

More info: http://www.apcomputerscience.com/ide/jcreator/index.htm or JCreator (http://www.jcreator.com/) 

Processing 

Processing is an enhanced IDE. It adds some extra commands and a simplified programming model. This makes it much easier for beginners to Start programming in Java. It was 
designed to help graphic artists learn a bit of programming without struggling too much. Processing runs on Windows, GNU/Linux and Mac OS X platforms. 

More info: Processing (http://www.processing.org). 

BlueJ 

BlueJ is an IDE that includes templates and will compile and run the applications for you. BlueJ is often used by classes because it is not necessary to set classpaths. BlueJ has its 
own sets of libraries and you can add your own under preferences. That sets the classpath for all compilations that come out of it to include those you have added and the BlueJ 
libraries. 
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BlueJ offers an interesting GUI for creation of packages and programs. Classes are represented as boxes with arrows running between them to 
represent inheritance/implementation or if on is constructed in another. BlueJ adds all those classes (the project) into the classpath at compile 
time. 


More info: BlueJ Homesite (http://www.bluej.org) 


Kawa 


Kawa is basically a Java editor developed by Tek-Tools. It does not include wizards and GUI tools, best suited to experienced Java programmers 
in small and midsized development teams. It looks that there is no new development for Kawa. 

See also a javaworld article (http://www.javaworld.com/javaworld/jw-06-2000/jw-0602-iw-kawa.html) 

JBuilder 

JBuilder is an IDE with proprietary source code, sold by Embarcadero Technologies. One of the advantages is the integration with Together, a modeling tool. 
More info: Embarcadero (http://www.embarcadero.com/). 

Drjava 

DrJava is an IDE developed by the JavaPLT group at Rice University. It is designed for students. 

For more Information see DrJava ( http://www.drjava.org ). 

Other IDEs 

■ Geany 

■ IntelliJ IDEA 

■ JDeveloper 

■ jGRASP 

■ jEdit 

■ MyEclipse 

■ Visual Cafe 

■ Gel (http://www.gexperts.com/products/gel/download.php) 

■ JIPE (http://jipe.sourceforge.net/) 

■ Zeus (http://www.zeusedit.com/java.html) 

■ setu IDE (http://www.setuide.net84.net) 



Language Fundamentals 

The previous chapter "Getting started" was a primer course in the basics of understanding how Java programming works. Throughout the chapter, we tackled a variety of concepts 
that included: 

■ Objects and dass definitions; 

■ Abstract and data types; 

■ Properties; 

■ Methods; 

■ Class-level and method-level scopes; 

■ Keywords; and, 

■ Access modifiers, etc. 

From this point on, we will be looking into the above mentioned concepts and many more in finer detail with a deeper and richer understanding of how each one of them works. 

This chapter on Language fundamentals introduces the fundamental elements of the Java programming language in detail. The discussions in this chapter will use the concepts we 
have already gathered from our previous discussions and build upon them in a progressive manner. 

The Java programming syntax 

In linguistics, the word syntax (which comes from Ancient Greek ovvmdig where <rvv [syn] means "together", and zädig [täxis] means "an ordering") refers to "the process of 
arranging things". It defines the principles and rules for constructing phrases and sentences in natural languages. 

When learning a new language, the first Step one must take is to learn its programming syntax. Programming syntax is to programming languages what grammar is to spoken 
languages. Therefore, in Order to create effective code in the Java programming language, we need to learn its syntax — its principles and rules for constmcting valid code 
Statements and expressions. 

Java uses a syntax similar to the C programming language and therefore if one learns the Java programming syntax, they automatically would be able to read and write programs in 
similar languages — C, C++ and C# 

The next Step one must take when learning a new language is to learn its keywords; by combining the knowledge of keywords with an understanding of syntax rules, one can create 
Statements, Programming Blocks, Classes, Interfaces, et al. 

Use packages to avoid name collisions. To hide as much information as possible use the access modifiers properly. 

Create methods that do one and if possible only one thing/task. If possible have separate method that changes the object state. 

In an object oriented language, programs are run with objects; however, for ease of use and for historic reasons, Java has primitive types. Primitive Data Types only störe values and 
have no methods. Primitive Types may be thought of as Raw Data and are usually embedded attributes inside objects or used as local variables in methods. Because primitive types 
are not subclasses of the object superclass, each type has a Wrapper Class which is a subclass of Object, and can thus be stored in a collection or returned as an object. 

Java is a strong type checking language. There are two concepts regarding types and objects. One is the object type and the other the template/class the object was created from. 
When an object is created, the template/class is assigned to that object which can not be changed. Types of an object however can be changed by type casting. Types of an object is 
associated with the object reference that referencing the object and determines what Operation can be performed on the object through that object reference. Assigning the value of 
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one object reference to a different type of object reference is called type casting. 

The most often used data structure in any language is a character string. For this reason java defines a special object that is String. 

To aggregate same type java objects to an array, java has a special array object for that. Both java objects and primitive types can be aggregated to arrays. 


Statements 


Now, that we have the Java platform on our Systems and have run the first program successfully, we are geared towards understanding how programs are actually made. As we have 
already discussed, a program is a set of instructions, which are tasks provided to a Computer. These instructions are called Statements in Java. Statements can be anything from a 
single line of code to a complex mathematical equation. Consider the following line: 



Code section 3.1: A simple assignment Statement. 

1 -1 

■1 int age = 24; i 

l_i 


This line is a simple instruction that teils the System to initialize a variable and set its value as 24. If the above Statement was the only one in the program, it would look similar to 
this: 


Code listing 3.1: A Statement in a simple dass. 


i-1 

11 public dass MyProgram { 1 

12 public static void main (String[] args) { 1 

13 int age = 24; 1 

■4 } ; 

■5 } ; 

i_! 


Java places its Statements within a dass declaration and, in the dass declaration, the Statements are usually placed in the method declaration, as above. 

Variable declaration Statement 


The simplest Statement is a variable declaration: 



Code section 3.2: A simple declaration Statement. 

■-1 

■1 int age; i 

l_i 


It defines a variable that can be used to störe values for later use. The first token is the data type of the variable (which type of values this variable can störe). The second token is 
the name of the variable, by which you will be referring to it. Then each declaration Statement is ended by a semicolon (;). 


Assignment Statements 


Up until now, we've assumed the creation of variables as a single Statement. In essence, we assign a value to those variables, and that's just what it is called. When you assign a value 
to a variable in a Statement, that Statement is called an assignment Statement (also called an initialization Statement). Did you notice one more thing? It's the semicolon (;), which is 
at the end of each Statement. A clear indicator that a line of code is a Statement is its termination with an ending semicolon. If one was to write multiple Statements, it is usually done 
on each separate line ending with a semicolon. Consider the example below: 



Code section 3.3: Multiple assignment Statements. 

i-1 


il int a = 10; 
[2 int b = 20; 
|3 int c = 30; 


You do not necessarily have to use a new line to write each Statement. Just like English, you can begin writing the next Statement where you ended the first one as depicted below: 


^ Code section 3.4: Multiple assignment Statements on the same line. 


■1 int a = 10; int b = 20; int c = 30; 

1 _ 


However, the only problem with putting multiple Statements on one line is, it’s very difficult to read it. It doesn’t look that intimidating at first, but once you’ve got a significant 
amount of code, it's usually better to organize it in a way that makes sense. It would look more complex and incomprehensible written as it is in Listing 3.4. 

Now that we have looked into the anatomy of a simple assignment Statement, we can look back at what we’ve achieved. We know that... 

■ A Statement is a unit of code in programming. 

■ If we are assigning a variable a value, the Statement is called an assignment Statement. 

■ An assignment Statement includes three parts: a data type, the variable name (also called the identifier) and the value of a variable. We will look more into the nature of 
identifiers and values in the section Variables later. 


Now, before we move on to the next topic, you need to try and understand what the code below does. 



Code section 3.5: Multiple assignment Statements with expressions. 

-, 


[1 int f irstNumber = 10; 
i2 int secondNumber = 20; 

[3 int result = firstNumber + secondNumber; 
■4 secondNumber = 30; 


1 
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The first two Statements are pretty much similar to those in Section 3.3 but with different variable names. The third however is a bit interesting. We’ve already talked of variables as 
being similar to gift boxes. Think of your computer’s memory as a shelf where you put all those boxes. Whenever you need a box (or variable), you call its identifier (that's the name 
of the variable). So calling the variable identifier f irstNumber gives you the number 10, calling secondNumber would give you 20 hence when you add the two up, the answer 
should be 30 . That's what the value of the last variable resuit would be. The part of the third Statement where you add the numbers, i.e., f irstNumber + secondNumber is called 
an expression and the expression is what decides what the value is to be. If it's just a plain value, like in the first two Statements, then it's called a literal (the value is literally the 
value, hence the name literal ). 

Note that after the assignment to resuit its value will not be changed if we assign different values to f irstNumber or secondNumber, like in line 4. 

With the information you have just attained, you can actually write a decent Java program that can sum up values. 

Assertion 


An assertion checks if a condition is true: 



Code section 3.6: A return Statement. 

I-1 

[1 public int get Age () { i 

i2 assert age >= 0; * 

[3 return age; 1 

! 4 } ■ 

1_I 


Each assert Statement is ended by a semi-colon (;). However, assertions are disabled by default, so you must run the program with the -ea argument in Order for assertions to be 
enabled (java -ea [name of compiled program]). 

Program Control Flow 

Statements are evaluated in the order as they occur. The execution of flow begins at the top most Statement and proceed downwards tili the last Statement is encountered. A 
Statement can be substituted by a Statement block. There are special Statements that can redirect the execution flow based on a condition, those Statements are called branching 
Statements, described in detail in a later section. 

Statement Blocks 

A bunch of Statements can be placed in braces to be executed as a single block. Such a block of Statement can be named or be provided a condition for execution. Below is how 
you’d place a series of Statements in a block. 

Code section 3.7: A Statement block. 


.1 { 

[2 int a = 10; 

■3 int b = 20; 

,4 int resuit = a + b; 

|5 } 

I_ 



Branching Statements 

Program flow can be affected using function/method calls, loops and iterations. Of various types of branching constructs, we can easily pick out two generic branching methods. 

■ Unconditional Branching 

■ Conditional Branching 

Unconditional Branching Statements 

If you look closely at a method, you’ll see that a method is a named Statement block that is executed by calling that particular name. An unconditional branch is created either by 
invoking the method or by calling break, continue, return or throw, all of which are described below. 

When a name of a method is encountered in a flow, it stops execution in the current method and branches to the newly called method. After returning a value from the called 
method, execution picks up at the original method on the line below the method call. 

□ 


Output provided with the screen of information running the above 
code. 


Inside main method! Invoking aMethod! 
Inside aMethod! 

Back in main method! 

I_ 


Code listing 3.8: UnconditionalBranching.java 

;-1 

i 1 public dass UnconditionalBranching { 
i 2 public static void main (String[] args) { 

i 3 System. out . println (" Inside main method! Invoking aMethod!"); 

i 4 aMethod(); 

i 5 System. out . printin ( "Back in main method!"); 

! 6 } 

! 7 

i 8 public static void aMethod () { 

i 9 System. out . println (" Inside aMethod!"); 

!l0 } 

In } 


The program flow begins in the main method. Just as aMethod is invoked, the flow travels to the called method. At this very point, the flow branches to the other method. Once the 
method is completed, the flow is returned to the point it left off and resumes at the next Statement after the call to the method. 

Return Statement 

A return Statement exits from a block, so it is often the last Statement of a method: 

Code section 3.9: A return Statement. 

i-1 

i i 

il public int get Age () { i 

[2 int age = 24; * 

i return age; ■ 
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1 - 34 } 

L 

A return Statement can return the content of a variable or nothing. Beware not to write Statements after a return Statement which would not be executed! Each return Statement is 
ended by a semi-colon (;). 

Conditional Branching Statements 

Conditional branching is attained with the help of the if. . .eise and switch Statements. A conditional branch occurs only if a certain condition expression evaluates to true. 

Conditional Statements 


Also referred to as if Statements, these allow a program to perform a test and then take action based on the result of that test. 
The form of the if Statement: 


-1 

if ( condition ) { i 

do Statements here if condition is true , 

} eise { 1 

do Statements here if condition is false i 

} : 


The condition is a boolean expression which can be either true or false. The actions performed will depend on the value of the condition. 


Example: 



Code section 3.10: An if Statement. 


T 


!l if (i > 0) { 

[2 System. out . printin ( "value stored in i is greater than zero") ; 

■3 } eise { 

[4 System. out . printin ( "value stored is not greater than zero") ; 
|5 } 


If Statements can also be made more complex using the eise if combination: 


- 1 

if (condition 1) { i 

do Statements here if condition 1 is true , 

} eise if (condition 2) ( 1 

do Statements here if condition 1 is false and condition 2 is true , 

} eise { 1 

do Statements here if neither condition 1 nor condition 2 is true i 

} ! 


Example: 

Code section 3.11: An if/else if/else Statement. 

j-T 

|l if (i > 0) { ! 

■2 System. out . printin ( "value stored in i is greater than zero");, 

i3 } eise if (i < 0) { 1 

[4 System. out . println ( "value stored in i is less than zero"); i 
■5 } eise { 1 

[6 System. out.printin ( "value stored is equal to 0"); i 

; 7 } ; 

L_ 1 



If there is only one Statement to be executed after the condition, as in the above example, it is possible to omit the curly braces, however Oracle's Java Code Conventions 
(http://www.oracle.eom/teehnetwork/java/index.html#449) explicitly state that the braces should always be used. 

There is no looping involved in an if Statement so once the condition has been evaluated the program will continue with the next instruction after the Statement. 

If...else Statements 


The if ... eise Statement is used to conditionally execute one of two blocks of Statements, depending on the result of a boolean condition. 
Example: 

Code section 3.12: An if/else Statement. 


!i 

\ 2 

>3 

[4 

[5 


if (list == null) { 

// This block of Statements executes if the condition is true. 

} eise { 

// This block of Statements executes if the condition is false. 

} 



Oracle's Java Code Conventions (http://www.oraele.eom/teehnetwork/java/index.html#449) recommend that the braces should always be used. 
An if Statement has two forms: 


■- 1 

'if ( boolean-condition) i 

1 Statement 1 , 

1 __ 

and 


-1 

if ( boolean-condition) i 

Statement 1 , 

eise f 

Statement 2 ■ 


Use the second form if you have different Statements to execute if the boolean-condition is true or if it is false. Use the first if you only wish to execute Statement 7 if the condition is 
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true and you do not wish to execute alternate Statements if the condition is false. 

The code section 3.13 calls two int methods, f () and y (), Stores the results, then uses an if Statement to test if x is less than y and if it is, the Statementj body will swap the 
values. The end result is x always contains the larger result and y always contains the smaller result. 

Code section 3.13: Value swap. 


[l int x = f () ; 
|2 int y = y () ; 
i3 if (x < y) { 
[4 int z = x; 
i5 x = y; 

|6 y = z; 

| 7 } 



if ...eise Statements also allow for the use of another Statement, eise if . This Statement is used to provide another if Statement to the conditional that can only be executed if the 
others are not true. For example: 


Code section 3.14: Multiple branching. 

■-1 

■1 if (x == 2) i 

i2 x = 4; [ 

[3 eise if (x == 3) 1 

i4 x = 6; | 

[5 eise 1 

J6 x = -1; 1 


The eise if Statement is useful in this case because if one of the conditionals is true, the other must be false. Keep in mind that if one is true, the other will not execute. For 
example, if the Statement at line 2 contained in the first conditional were changed to x = 3 ;, the second conditional, the eise if , would still not execute. However, when dealing 
with primitive types in conditional Statements, it is more desirable to use switch Statements rather than multiple eise if Statements. 

Switch Statements 

The switch conditional Statement is basically a shorthand Version of writing many if ...eise Statements. The syntax for switch Statements is as follows: 


i-1 

iswitch (<variable>) { i 

J case <result>: <statements>; break; , 

i case <result>: <statements>; break; 1 

, default: <statements>; break; i 

! } ! 

I_! 

This means that if the variable included equals one of the case results, the Statements following that case, until the word break will run. The default case executes if none of the 
others are true. Note: the only types that can be analysed through switch Statements are char, byte, short, or int primitive types. This means that Object variables can not by 
analyzed through switch Statements. However, as of the JDK 7 release, you can use a String object in the expression of a switch Statement. 

Code section 3.15: A switch. 

;-1 

i ■ 

i 1 int n = 2, x; i 

1 2 switch (n) { [ 

i 3 case 1 : x = 2; 1 

[ 4 break; ! 

i 5 case 2: x = 4; 1 

, 6 break; i 

1 7 case 3: x = 6; [ 

i 8 break; ■ 

[ 9 case 4: x = 8; [ 

ilO break; 1 

Jn } ! 

■12 return x; 1 

i 1 

l_ 1 



In this example, since the integer variable n is equal to 2, case 2 will execute, make x equal to 4. Thus, 4 is returned by the method. 

Iteration Statements 

Iteration Statements are Statements that are used to iterate a block of Statements. Such Statements are often referred to as loops. Java offers four kinds of iterative Statements. 

■ The while loop 

■ The do. . .while 100p 

■ The for loop 

■ The foreach loop 


The while loop 

The while loop iterates a block of code while the condition it specifies is true. 

The syntax for the loop is: 

1-1 

iwhile (condition) { i 

, Statement; , 

! } ! 

1_1 

Here the condition is an expression. An expression as discussed earlier is any Statement that returns a value. while condition Statements evaluate to a boolean value, that is, either 
true or false. As long as the condition is true, the loop will iterate the block of code over and over and again. Once the condition evaluates to false, the loop exits to the next 
Statement outside the loop. 

The do...while loop 

The do-while loop is functionally similar to the while loop, except the condition is evaluated AFTER the Statement executes 

■- 1 

■do { 1 
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, Statement; 

1 } while (condition); 


The for loop 

The for loop is a specialized while loop whose syntax is designed for easy iteration through a sequence of numbers. Example: 


m 


Code section 3.16: A for loop. 



U 


Output for code listing 3.16 if you compile and run the Statement above. 



The program prints the numbers 0 to 99 and their squares. 
The same Statement in a while loop: 


Code section 3.17: An alternative Version. 

i-1 

il int i = 0; i 

[2 while (i < 100) { [ 

■3 System. out . print ln (i + "\t" + i * i); 1 
[4 i + +; ! 

;5 } ; 



The foreach loop 


The foreach Statement allows you to iterate through all the items in a collection, examining each item in turn while still preserving its type. The syntax for the foreach Statement is: 

■-1 

Jfor (type item : collection) Statement; i 

l_i 


For an example, well take an array of strings denoting days in a week and traverse through the collection, examining one item at a time. 



Code section 3.18: A foreach loop. 

i-1 


il String[] days = {"Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"}; 

[2 

■3 for (String day : days) { 

[4 System. out . printin (day); 

|5 } 

L_ 



Output for code listing 3.18 


;- 1 

iMonday 1 

iTuesday 1 

iWednesday 1 

iThursday 1 

iFriday 1 

iSaturday 1 

iSunday 1 

i_! 


Notice that the loop automatically exits after the last item in the collection has been examined in the Statement block. 

Although the enhanced for loop can make code much clearer, it can't be used in some common situations. 

■ Only access. Elements can not be assigned to, eg, not to increment each element in a collection. 

■ Only single structure. It's not possible to traverse two structures at once, eg, to compare two arrays. 

■ Only single element. Use only for single element access, eg, not to compare successive elements. 

■ Only forward. It's possible to iterate only forward by single Steps. 

■ At least Java 5. Don't use it if you need compatibility with versions before Java 5. 

The continue and break Statements 

At times, you would like to re-iterate a loop without executing the remaining Statement within the loop. The continue Statement causes the loop to re-iterate and Start over from the 
top most Statement inside the loop. 

Where there is an ability to re-iterate the loop, there is an ability to exit the loop when required. At any given moment, if you’d like to exit a loop and end all further work within the 
loop, the break ought to be used. 

The continue and break Statements can be used with a label like follows: 

Code section 3.19: Using a label. 

i-1 

>1 String s = "A test string for the switch! \nLine two of fest string... ";i 
[2 outer: for (int i = 0; i < s . length () ; i++) { * 

■3 switch (s . charAt (i) ) { 1 

i4 case ’\n’ : break outer; , 

[5 case ’ 1 : break; 1 

■6 default: System. out . print (s. charAt (i)); i 

b } : 

i 8 } - 

L_I 



Output for code listing 3.19 

i-I 

i Ateststringfortheswitch! 1 

I-! 


Throw Statement 

A throw Statement exit from a method and so on and so on or it is caught by a try/catch block. It does not return a variable but an exception: 

Code section 3.20: A return Statement. 

|-T 

I public int getAge () { i 
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I 1 2 

■3 


throw new NullPointerExceptioi 


Beware not to write Statements after a throw Statement which would not be executed too! Each throw Statement is ended by a semi-colon (;). 

try/catch 


A try/catch must at least contain the try block and the catch block: 


m 


Code section 3.21: try/catch block. 


,1 try { 

■2 // Some code 

i3 } catch (Exception e) { 

[4 // Optional exception handling 

■5 } finally { 

[6 // This code is executed no matter what 

■7 } 


Test your knowledge 


Question 3.1: How many Statements are there in this dass? 


Code listing 3.2: AProgram.java 


1 

2 

3 

4 

5 

6 

7 

8 
9 

110 

111 
!l 2 
II 3 


public dass AProgram { 

private int age = 24; 

public static void main (String[] args) { 

int daysInAYear = 365; int agelnDay = 100000; 
int localAge = agelnDay / daysInAYear; 

} 

public int getAge () { 

return age; 

} 


l_' 


Answer 


One Statement at line 3, two Statements at line 6, one Statement at line 7 and one Statement at line 11. 


Conditional blocks 


Conditional blocks allow a program to take a different path depending on some condition(s). These allow a program to perform a test and then take action based on the result of that 
test. In the code sections, the actually executed code lines will be highlighted. 

If 

The if block executes only if the boolean expression associated with it is true. The structure of an if block is as follows: 

if (boolean expression /) { 

statementj 

statement 2 

statement n 


} 


Here is a double example to illustrate what happens if the condition is true and if the condition is false: 



Code section 3.22: Two if blocks. 


1 int age = 6; 

2 System.out. printin (" Hello! ") ; 

3 

4 if (age < 13) { 

5 System. out . println (" I ' m a child."); 

6 } 

7 

8 if (age > 20) { 

9 System. out . printin ("I' m an adult."); 

10 } 

11 

12 System. out . println ( "Bye! " ) ; 


Output for Code section 3.22 

i-1 

iHello! 1 2 3 4 5 6 7 8 9 10 11 12 

il ' m a child 1 

iBye ! 1 

L_! 


f 


If only one Statement is to be executed after an if block, it does not have to be enclosed in curly braces. For example, if (i == 0) i = l ; is a perfectly valid portion of 
Java code. This works for most control structures, such as eise and whiie. However Oracle's Java Code Conventions (http://www.oracle.com/technetwork 
/java/index.html#449) explicitly state that the braces should always be used. 
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If/else 

The if block may optionally be followed by an eise block which will execute if that boolean expression is false. The structure of an if block is as follows: 

if 0 boolean expressionj) { 

statementj 

statement2 

Statement n 
} eise { 

Statementjbi s 

statement2bi s 

Statement n bi s 


} 


If/else-if/else 

An eise-if block may be used when multiple conditions need to be checked. eise-if Statements come after the if block, but before the eise block. The structure of an if block 
is as follows: 


if 0 boolean expression /) { 

statementj j 
statementj 2 

statement n 

} eise if ( boolean expression ) { 

statement2j 

statement23 

statement2 M 

} eise { 

Statement3 j 
statement 3 2 

statement3 n 


} 


Here is an example to illustrate: 


Code listing 3.3: MyConditionalProgram.java 


1 public dass MyConditionalProgram { 


2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 } 


public static void main (String [] args) { 
int a = 5; 
if (a > 0) { 

// a is greater than 0, so this Statement will execute 
System. out . println (" a is positive"); 

} eise if (a >= 0 ) { 

// a case has already executed, so this Statement will NOT execute 
System. out . printin (" a is positive or zero") ; 

} eise { 

// a case has already executed, so this Statement will NOT execute 
System. out . println ( " a is negative" ); 


} 


} 



Output for code listing 3.3 


i-1 

ia is positive 1 

l_ 1 


Keep in mind that only a single block will execute, and it will be the first true condition. 

All the conditions are evaluated when if is reached, no matter what the result of the condition is, after the execution of the if block: 



Code section 3.23: A new value for the variable a. 

i-1 


1 int a = 5; 

2 if (a > 0) { 

3 // a is greater than 0, so this Statement will execute 

4 System. out . println ("a is positive"); 

5 a = -5; 

6 } eise if (a < 0) { 

7 // a WAS greater than 0, so this Statement will not execute 

8 System. out . println (" a is negative" ); 

9 } eise { 

10 // a does not equal 0, so this Statement will not execute 

11 System. out . println ("a is zero") ; 


Output for code section 3.23 
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1 *12 } 


Conditional expressions 

Conditional expressions use the compound ? : operator. Syntax: 


boolean expressiotij ? eiDepressionj : expression 

This evaluates boolean expressions and if it is true then the conditional expression has the value of expressions otherwise the conditional expression has the value of 

expres s ion2- 


Example: 

Code section 3.24: Conditional expressions. 

i- 

■1 String answer = (p < 0.05)? "reject" : "keep"; 



1 


This is equivalent to the following code fragment: 

Code section 3.25: Equivalent code. 


■1 String answer; 
i2 if (p < 0.05) { 

[3 answer = "reject"; 

■4 } eise { 

[5 answer = "keep"; 

|6 } 



Switch 

The switch conditional Statement is basically a shorthand Version of writing many if ...eise Statements. The switch block evaluates a char, byte, short, or int (or enum, starting 
in J2SE 5.0; or string, starting in J2SE 7.0), and, based on the value provided, jumps to a specific case within the switch block and executes code until the break command is 
encountered or the end of the block. If the switch value does not match any of the case values, execution will jump to the optional defauit case. 

The structure ofaswitch Statement is as follows: 


switch (intj or charj or short 1 or bytej or enumj or String valuej) { 

case case valuep. 

Statement 11 

Statementj n 
break; 

case case value 2 '. 
statement 2 j 

statement2 M 

break; 

defauit: 

statement n j 

Statement nn 


} 


Here is an example to illustrate: 



Code section 3.26: A switch block. 


-1 

1 int i = 3; i 

2 switch (i) { [ 

3 case 1: ■ 

4 // i doesn't equal 1 , so this code won't execute i 

5 System. out . printin (" i equals 1"); 1 

6 break; i 

7 case 2: [ 

8 // i doesn't equal 2 , so this code won't execute ■ 

9 System. out.printin ( "i equals 2"); , 

10 break; 1 

11 defauit: i 

12 // i has not been handled so far, so this code will execute' 

13 System. out . printin (" i equals something other than 1 or 2");i 

14 } | 



Output for code section 3.26 


i -1 

ii equals something other than 1 or 2 1 

L_! 


If a case does not end with the break Statement, then the next case will be checked, otherwise the execution will jump to the end of the switch Statement. 
Look at this example to see how it's done: 



Code section 3.27: A switch block containing a case without break. 

i-1 


1 

2 

3 

4 

5 

6 


int i = -1; 

switch (i) { 

case -1: 
case 1 : 

// i is —1, so it will fall through 
System. out . printin (" i is 1 or -1"); 

break; 


to this case and execute 


this 


code 


Output for code section 3.27 
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7 8 case 0 : 

9 // The break command is used before this case, so if i is 1 or -1, this will not execute 

10 System. out . printin ("i is 0"); 

11 } 



Starting in J2SE 5.0, the switch Statement can also be used with an enum value instead of an integer. 

Though enums have not been covered yet, here is an example so you can see how it's done (note that the enum constants in the cases do not need to be qualified with the type: 



Code section 3.28: A switch block with an enum type. 

- - n 


1 Day day = Day.MONDAY; // Day is a fictional enum type containing the days of the vn 

2 switch (day) { J 

3 case MONDAY: ' 

4 // Since day == Day.MONDAY, this Statement will execute , 

5 System. out . println ( "Mondays are the worst!") ; 1 

6 break; i 

7 case TUESDAY: [ 

8 case WEDNESDAY: ■ 

9 case THURSDAY: ! 

10 System. out.printin ( "Weekdays are so-so. ") ; 1 

11 break; i 

12 case FRIDAY: ] 

13 case SATURDAY: i 

14 case SUNDAY: ! 

15 System. out . printin ( "Weekends are the best!"); 1 

16 break; i 

17 } ; 


L 



Output for code section 3.28 


1 


iMondays are the worst ! 

L_ 


Starting in J2SE 7.0, the switch Statement can also be used with an string value instead of an integer. 



Code section 3.29: A switch block with a String type. 


-, 

1 String day = "Monday"; i 

2 switch (day) { J 

3 case "Monday" : 1 

4 // Since day == "Monday", this Statement will execute , 

5 System. out . println ( "Mondays are the worst!"); 1 

6 break; i 

7 case "Tuesday": J 

8 case "Wednesday" : ■ 

9 case "Thursday": ! 

10 System. out.printin ( "Weekdays are so-so."); 1 

11 break; i 

12 case "Friday" : j 

13 case "Saturday": i 

14 case "Sunday": [ 

15 System. out . printin ( "Weekends are the best!"); 1 

16 break; i 

17 default: [ 

18 throw new IHegalArgumentException( "Invalid day of the week: " + day);i 

19 } ! 



Output for code section 3.29 


i-1 

iMondays are the worst! 1 

L_ 1 


Loop blocks 

Loops are a handy tool that enables programmers to do repetitive tasks with minimal effort. Say we want a program that can count from 1 to 10, we could write the following 
program. 


Code listing 3.4: Count.java 



Output for code listing 3.4 


i 1 dass Count { 

i 2 public static void main (String [] args) { 

i 3 System. out . println ('1 '); 

i 4 System. out . printin ('2 '); 

i 5 System. out . printin ('3 '); 

i 6 System. out.printin ('4 '); 

i 7 System. out.printin ('5 '); 

i 8 System. out.printin ('6 '); 

i 9 System. out . println ('7 '); 

110 System . out . print ln ('8 '); 

111 System . out . printin ('9 '); 

il 2 Sy stem . out . print ln ('10 '); 

■13 } 

■ 14 } 

I_ 



The task will be completed just fine, the numbers 1 to 10 will be printed in the output, but there are a few problems with this solution: 

■ Flexibility: what if we wanted to change the Start number or end number? We would have to go through and change them, adding extra lines of code where they're needed. 

■ Scalability: 10 repeats are trivial, but what if we wanted 100 or even 1000 repeats? The number of lines of code needed would be overwhelming for a large number of 
iterations. 

■ Maintenance: where there is a large amount of code, one is more likely to make a mistake. 

■ Feature: the number of tasks is fixed and doesn't change at each execution. 

Using loops we can solve all these problems. Once you get you head around them they will be invaluable to solving many problems in programming. 

Open up your editing program and create a new file saved as Loop. java. Now type or copy the following code: 


Code listing 3.5: Loop.java 



Output for code listing 3.5 
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11 dass Loop { 

12 public static void main (String [ ] args) { 

13 int i; 

14 for (i = 1; i <= 10; i + + ) { 

15 System. out . print ln ( i + ' '); 

■6 } 

■7 } 

! 8 } 


!i 

12 

13 

U 

15 

16 

17 

18 

19 

Il 0 

I- _ 


If we run the program, the same result is produced, but looking at the Code, we immediately see the advantages of loops. Instead of executing 10 different lines of code, line 5 
executes ten times. 10 lines of code have been reduced to just 4. Furthermore, we may change the number 10 to any number we like. Try it yourself, replace the 10 with your own 
number. 

While 

while loops are the simplest form of loop. The while loop repeats a block of code while the specified condition is true. Here is the structure of a while loop: 

while ( boolean expressiotij) { 

statementj 

statement2 

statement n 


} 


The loop's condition is checked before each iteration of the loop. If the condition is false at the Start of the loop, the loop will not be executed at all. The code section 3.28 sets in 
squareHigherThan2 o o the smallest integer whose square exceeds 200. 

PP Code section 3.28: The smallest integer whose square exceeds 200. 


il int squareHigher Than2 0 0 = 0; i 

[2 I 

i3 while (squareHigherThan200 * squareHigherThan200 < 200) { 1 

,4 squareHigherThan200 = squareHigherThan200 + 1; i 

;5 } ; 

I_! 

If a loop's condition will never become false, such as if the true constant is used for the condition, said loop is known as an infinite loop. Such a loop will repeat 
indefinitely unless it is broken out of. Infinite loops can be used to perform tasks that need to be repeated over and over again without a definite stopping point, such as 
updating a graphics display. 

Do... while 

The do-while loop is functionally similar to the while loop, except the condition is evaluated AFTER the Statement executes It is useful when we try to find a data that does the job 
by randomly browsing an amount of data. 


do { 


statementj 

statement2 

statement n 

} while (boolean expressionjf, 


For 

The for loop is a specialized while loop whose syntax is designed for easy iteration through a sequence of numbers. It consists of the keyword for followed by three extra 
Statements enclosed in parentheses. The first Statement is the variable declaration Statement, which allows you to declare one or more integer variables. The second is the condition, 
which is checked the same way as the while loop. Last is the iteration Statement, which is used to increment or decrement variables, though any Statement is allowed. 

This is the structure of a f or loop: 


for ( variable declarations; condition ; iteration Statement ) { 

statementj 

statement2 

statement n 


} 


To clarify how a for loop is used, here is an example: 


Code section 3.29: A for loop. 

i-1 

il for (int i = 1; i <= 10; i + +) {■ 

[2 System . out . printin ( i ) ; j 

j 3 } ; 

1 _ 1 




Output for code listing 3.29 


1 

2 

3 

4 
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15 

16 

17 

18 

19 

!io 


L 


The for loop is like a template Version of the while loop. The alternative code using a while loop would be as follows: 

^ Code section 3.30: An iteration using a while loop. 


1 int i = 1; 

2 while (i <= 10) { 

3 System. out . println ( i) ; 

4 i + + ; 

5 } 


The code section 3.31 shows how to iterate with the for loop using multiple variables and the code section 3.32 shows how any of the parameters of a for loop can be skipped. 
Skip them all, and you have an infinitely repeating loop. 



Code section 3.31: The for loop using multiple variables. 

I-1 

[lfor (int i = 1, j = 10; i <= 10 ; i + + , j —) { i 

i2 System, out .print (i + " "); ’ 

[3 System . out . printin ( j ) ; ■ 

! 4 } ■ 



Code section 3.32: The for loop without parameter. 

i-1 

il for (; ; ) { ■ 

[2 // Some code j 

! 3 } ! 

1 _ 1 


For-each 


Arrays haven’t been covered yet, but you’ll want to know how to use the enhanced for loop, called the for-each loop. The for-each loop automatically iterates through a list or 
array and assigns the value of each index to a variable. 

To understand the structure of a for-each loop, look at the following example: 



Code section 3.33: A for-each loop. 
-! 


[1 String[] sentence = {"I", "am", "a", "Java", "program."}; 

i2 for (String word : sentence) { 

,3 System . out . print (word + " "); 

■4 } 


L 



Output for code section 3.33 


il am a Java program. 

L_ 


The example iterates through an array of words and prints them out like a sentence. What the loop does is iterate through sentence and assign the value of each index to word, then 
execute the code block. 

Here is the general contract of the for-each loop: 


for {variable declaration : array or list ) { 

statementj 

statement 2 

statement n 


} 


Make sure that the type of the array or list is assignable to the declared variable, or you will get a Compilation error. Notice that the loop automatically exits after the last item in the 
collection has been examined in the Statement block. 

Although the enhanced for loop can make code much clearer, it can’t be used in some common situations. 

■ Only access. Elements can not be assigned to, eg, not to increment each element in a collection. 

■ Only single structure. It's not possible to traverse two structures at once, eg, to compare two arrays. 

■ Only single element. Use only for single element access, eg, not to compare successive elements. 

■ Only forward. It's possible to iterate only forward by single Steps. 

■ At least Java 5. Don't use it if you need compatibility with versions before Java 5. 


Break and continue keywords 


The break keyword exits a flow control loop, such as a for loop. It basically breaks the loop. 

In the code section 3.34, the loop would print out all the numbers from 1 to 10, but we have a check for when i equals 5. When the loop reaches its fifth iteration, it will be cut short 
by the break Statement, at which point it will exit the loop. 



Code section 3.34: An interrupted for loop. 

;- 1 


,1 for (int i = 1; i <= 10; i + +) { 

■2 System. out . printin (i); 

b if (i == 5) { 

[4 System. out . print ln (" STOP ! " ) ; 

i5 break; 

|6 } 

|7 } 



Output for code section 3.34 


!i 

12 

13 

14 
■5 

iSTOP ! 

I_ 
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The continue keyword jumps straight to the next iteration of a loop and evaluates the boolean expression Controlling the loop. The code section 3.35 is an example of the 
continue Statement in action: 



Code section 3.35: A for loop with a skipped iteration. 

;-i 


,1 for (int i = 1; i <= 10; i + +) { 

■2 if (i == 5) { 

i3 System. out .printin( "Caught i == 5"); 

[4 continue; 

■5 } 

[6 System. out . printin (i); 

■7 } 


L 



Output for code section 3.35 


!i 

i2 

',3 

U 

iCaught i == 5 

'i6 

17 

18 

19 

IlO 

L__ 


1 


As the break and continue Statements reduce the readability of the code, it is recommended to reduce their use or replace them with the use of if and while blocks. Some IDE 
refactoring operations will fail because of such Statements. 


Test your knowledge 

Question 3.2: Consider the following code: 



Question 3.2: Loops and conditions. 


n 


1 int numberOfItems = 5; 

2 int currentltems = 0; 

3 int currentCandidate = 1; 

4 

5 while (currentltems < numberOfItems) { 

6 currentCandidate = currentCandidate + 1; 

7 System. out . println (" Test with integer: " + currentCandidate); 

8 


9 boolean found = true; 

10 for (int i = currentCandidate - 1; i > 1; i —) { 

11 

12 // Test if i is a divisor of currentCandidate 

13 if ((currentCandidate % i) == 0) { 

14 System. out . printin ( "Not matching..."); 

15 found = false; 

16 break; 

17 } 

18 

19 } 

20 

21 if (found) { 

22 System,out.println( "Matching!" ); 

23 currentltems = currentltems + 1; 

24 } 

25 } 

26 

27 System. out . println ( "Find the value: " + currentCandidate); 


What will be printed in the Standard output? 
Answer 


iTest with 

integer : 

2 

iMatching ! 



iTest with 

integer : 

3 

iMatching ! 



iTest with 

integer : 

4 

iNot matchi 

ng. . . 


iTest with 

integer: 

5 

iMatching ! 



iTest with 

integer: 

6 

iNot matchi 

ng. . . 


iTest with 

integer: 

7 

iMatching ! 



iTest with 

integer : 

8 

iNot matchi 

ng. . . 


iTest with 

integer : 

9 

iNot matchi 

ng. . . 


iTest with 

integer: 

10 

iNot matchi 

ng. . . 


iTest with 

integer : 

11 

iMatching ! 



iFind the value: 11 



I, 


23 


Output for Question 3.2 


The snippet is searching the 5 th prime number, that is to say: 11. It iterates on each positive integer from 2 (2, 3, 4, 5, 6 , 7, 8 , 9, 10, 11...), among them, it counts the prime 
numbers (2, 3, 5, 7, 11) and it stops at the 5 th one. 

So the snippet first iterates on each positive integer from 2 using the while loop: 



Answer 3.2.1: while loop. 


-, 

1 int numberOfItems = 5; i 

2 int currentltems = 0; , 

3 int currentCandidate = 1; ■ 

4 | 

5 while (currentltems < numberOfItems) { 1 

6 currentCandidate = currentCandidate + 1; i 

7 System. out . println (" Test with integer: " + currentCandidatl 

8 ' 

9 boolean found = true; , 

10 for (int i = currentCandidate - 1; i > 1; i—) { 1 

11 ! 

// Test if i is a divisor of currentCandidate ' 
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il2 13 if ( (currentCandidate % i) == 0) { 

14 System. out . println ( "Not matching..." ); 

■15 found = false; 

,16 break; 

■17 } 

11 8 

;i9 } 

■2 0 

[21 if (found) { 

■2 2 System.out .printin ("Matching!") ; 

i23 currentltems = currentltems + 1; 

[2 4 } 

12 5 } 

[2 6 

■27 System. out . printin ( "Find the value: " + currentCandidate); 


For each iteration, the current number is either a prime number or not. If it is a prime number, the Code at the left will be executed. If it is not a prime number, the code at the 
right will be executed. 



Answer 3.2.2: A prime number. 


-, 

1 int numberOfItems = 5; i 

2 int currentltems = 0; , 

3 int currentCandidate = 1; 1 

4 | 

5 while (currentltems < numberOf Items) { 11 

6 currentCandidate = currentCandidate + 1; i 

7 System. out . println (" Test with integer: " + currentCandidat, 

8 ' 

9 boolean found = true; , 

10 for (int i = currentCandidate - 1; i > 1; i—) { 1 

11 ! 

12 // Test if i is a divisor of currentCandidate 

13 if ((currentCandidate % i) == 0) { ■ 

14 System,out.println("Not matching..."); , 

15 found = false; 1 

16 break; i 

17 } ; 

18 I 

19 } ! 

20 
21 
22 

23 

24 

25 } 

26 

27 System. out . printin ( "Find the value: " + currentCandidate); 


if (found) { 

System .out.printin ( "Matching ! " ) ; 
currentltems = currentltems + 1; 

} 



Answer 3.2.3: Not a prime number. 


-, 

1 int numberOfItems = 5; i 

2 int currentltems =0; , 

3 int currentCandidate = 1; 1 

4 | 

5 while (currentltems < numberOfItems) { ! 

6 currentCandidate = currentCandidate + 1; i 

7 System. out . println (" Test with integer: " + currentCandidat, 

8 ' 

9 boolean found = true; , 

10 for (int i = currentCandidate - 1; i > 1; i--) { 1 

11 ! 

12 // Test if i is a divisor of currentCandidate 

13 if ((currentCandidate % i) == 0) { ■ 

14 System,out.println("Not matching..."); , 

15 found = false; 1 

16 break; i 

17 } ; 

18 I 

19 } ! 

20 1 

21 if (found) { ! 

22 System. out . println ( "Mat ching !") ; 1 

23 currentltems = currentltems + 1; i 

24 } J 

25 } ' 

26 ! 

27 System. out . println (" Find the value: " + currentCandidate); 1 


The prime numbers are counted using currentltems. When currentltems is equal to numberOf Items (5), the program go out of the while loop. currentCandidate 
contains the last number, that is to say the 5 th prime number: 



Answer 3.2.4: End of the program. 


T 


1 int numberOfItems = 5; 

2 int currentltems = 0; 

3 int currentCandidate = 1; 

4 

5 while (currentltems < numberOfItems) { 

6 currentCandidate = currentCandidate + 1; 

7 System. out . println (" Test with integer: " + currentCandidate); 


8 

9 boolean found = true; 

10 for (int i = currentCandidate - 1; i > 1; i—) { 

11 

12 // Test if i is a divisor of currentCandidate 

13 if ((currentCandidate % i) == 0) { 

14 System. out . printin ( "Not matching..."); 

15 found = false; 

16 break; 

17 } 

18 

19 } 

20 

21 if (found) { 

22 System.out .printin ("Matching!") ; 

23 currentltems = currentltems + 1; 

24 } 

25 } 

26 

27 System. out . printin ( "Find the value: " + currentCandidate); 


Labels 


Labels can be used to give a name to a loop. The reason to do this is so we can break out of or continue with upper-level loops from a nested loop. 
Here is how to label a loop: 

label name .loop 

To break out of or continue with a loop, use the break or continue keyword followed by the name of the loop. 

For example: 



Code section 3.36: A double for loop. 

■- ~\ 



1 

int 

1, 

j; 




2 

int 

[] [] 

nums = • 

r 


3 


(1, 

2, 

5}, 



4 


(6, 

9, 

7}, 



5 


(8, 

3, 

4} 



6 

}; 






7 







8 

Outer: 





9 

for 

(i 

= 0; 

i < 

nums.length; 

i + +) { 

.0 


for 

( j 

= 0; 

j < nums[i]. 

length; 


Output for code section 3.36 


iFound number 9 at (1, 1) 

1- 
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■11 if (nums [i] [j] == 9) { ■ 

il2 System. out . println ( "Found number 9 at (" + i + ", " + j + ")");! 

[13 break Outer; 1 

'14 } ! 

:i5 } : 

[16 } i 

L_i 

You needn’t worry if you don't understand all the code, but look at how the label is used to break out of the outer loop from the inner loop. However, as such a code is hard to read 
and maintain, it is highly recommended not to use labels. 

Try... catch blocks 

See also Throwing and Catching Exceptions. 

The try-catch blocks are used to catch any exceptions or other throwable objects within the code. 

Here's what try-catch blocks looks like: 

try { 

Statement ii 
Statement 12 

Statement i n 

} catch (exceptionj) { 

statement2j 

Statement2, n 

} 

The code listing 3.6 tries to print all the arguments that have been passed to the program. However, if there not enough arguments, it will throw an exception. 

Code listing 3.6: Attempt.java 


i 1 public dass Attempt { 1 

i 1 

i 2 public static void main (String[] args) { 1 

! 3 try { ■ 

i 1 

i 4 System. out . println (args [ 0]) ; 1 

i 1 

i 5 System. out . println (args [ 1]) ; 1 

i 1 

i 6 System. out . println (args[2]); 1 

i 1 

i 7 System. out . println (args[3]); 1 

i 1 

i 8 } catch (ArraylndexOutOfBoundsException e) {■ 

i 9 System. out . printin ( "No enough arguments"); 1 

110 } 1 

i 1 

111 } 1 

i 1 

il 2 } 1 

i 1 

I_ 1 

In addition to the try and catch blocks, a f inaiiy block may be present. The finally block is always executed, even if an exception is thrown. It may appear with or without a catch 

block, but always with a try block. 

Here is what a finally block looks like: 

try { 

Statement ii 

state me ntj 2 

Statement i n 
} catch (exception i) { 
statement2j 

statement2 M 
} finally { 

Statement3i 

Statement3 n 

} 


Examples 


The code listing 3.7 recieves a number as parameter and print its binary representation. 

Code listing 3.7: GetBinary.java 

i-- 

i 

1 1 public dass GetBinary { 

1 2 public static void main (String[] args) { 


1 
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, 3 if (args.length == 0) { , 

i 4 // Print usage , 

i 5 System. out . printin ( "Usage: java GetBinary <decimal integer>" ); , 

i 6 System. exit (0); J 

! 7 } eise { | 

i 8 // Print arguments , 

i 9 System. out . println ("Received " + args.length + " arguments."); , 

,10 System. out . printin (" The arguments are:" ); , 

111 for (String arg : args) { , 

112 Sy stem . out . print ln ("\t " + arg); , 

|i3 } ; 

!i4 } ; 

Il5 | 

,16 int number = 0; i 

Il7 String binary = | 

|l 8 | 

11 9 // Get the input number i 

12 0 try { ! 

121 number = Integer. parseint (args [ 0 ]) ; 1 

122 } catch (NumberFormatException ex) { 1 

123 System. out . printin ( "Error : argument must be a base-10 integer."); 1 

124 System. exit (0) ; 1 

,2 5 } ! 

',2 6 ! 

i27 // Convert to a binary string 1 

,2 8 do { ! 

12 9 switch (number % 2) { 1 

130 case 0: binary = '0' + binary; break; 1 

131 case 1: binary = '1' + binary; break; 1 

[32 } ! 

133 number >>= 1; 1 

134 } while (number >0); 1 

[35 ! 

i36 System. out . println ("The binary representation of " + args[0] + " is " + binary);i 

13 7 } ! 

i3 8 } ! 

L_I 


The code listing 3.8 is a Simulation of playing a game called Lucky Sevens. It is a dice game where the player rolls two dice. If the numbers on the dice add up to seven, he wins $4. 
If they do not, he loses $1. The game shows how to use control flow in a program as well as the fruitlessness of gambling. 


Code listing 3.8: LuckySevens.java 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 
4 6 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 


Import java.util.*; 

public dass LuckySevens { 

public static void main (String[] args) { 

Scanner in = new Scanner(System.in); 

Random random = new Random(); 

String input; 

int startingCash, cash, maxCash, rolls, roll; 

// Loop until "quit" is input 

while (true) { 

System. out . print ( "Enter the amount of cash to Start with (or \"quit\" to quit): "); 

input = in. nextLine (); 

// Check if user wants to exit 

if (input. toLowerCase (). equals ( "quit") ) { 

System. out . println (" \tGoodbye ." ); 

System. exit (0); 

} 

// Get number 

try { 

startingCash = Integer .parseint (input); 

} catch (NumberFormatException ex) { 

System. out . println (" \tPlease enter a positive integer greater than 0."); 

continue; 

} 

// You have to Start with some money! 
if (startingCash <= 0) { 

System. out . println (" \tPlease enter a positive integer greater than 0."); 

continue; 

} 

cash = startingCash; 
maxCash = cash; 
rolls = 0; 
roll = 0; 

// Here is the game loop 

for (; cash > 0; rolls++) { 

roll = random. nextInt (6) + 1; 

roll += random. nextlnt (6) + 1; 

if (roll == 7) 
cash += 4; 

eise 

cash -= 1; 

if (cash > maxCash) 
maxCash = cash; 

} 

System. out . println (" \tYou Start with $" + startingCash + ".\n" 

+ "\tYou peak at $" + maxCash + ",\n" 

+ "\tAfter " + rolls + " rolls, you run out of cash."); 

} 
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I '60 } 


Boolean expressions 


Boolean values are values that evaluate to either true or faise, and are represented by the boolean data type. Boolean expressions are very similar to mathematical expressions, 
but instead of using mathematical operators such as "+" or you use comparative or boolean operators such as "==" or 


Comparative operators 


Java has several operators that can be used to compare variables. For example, how would you teil if one variable has a greater value than another? The answer: use the 
"greater-than" operator. 

Here is a list of the comparative operators in Java: 


■ > : Greater than 

■ < : Less than 

■ >= : Greater than or equal to 

■ <= : Less than or equal to 

■ == : Equal to 

■ ! = : Not equal to 


To see how these operators are used, look at this example: 



Code section 3.37: Comparisons. 

i-1 


il int a = 5, b = 3; 

[2 System . out . print ln ( a > b); // Value 

■3 System. out .printin(a == b); // Value 

[4 System. out .printin(a != b); // Value 

|5 System. out . printin (b <= a); // Value 

1 _ 


is true because a is greater than b 
is faise because a does not equal b 
is true because a does not equal b 
is true because b is less than a 




Output for code section 3.37 


itrue 
if alse 
itrue 
itrue 

L_ 


Comparative operators can be used on any primitive types (except boolean), but only the "equals" and "does not equal" operators work on objects. This is because the 
less-than/greater-than operators cannot be applied to objects, but the equivalency operators can. 

Specifically, the == and ! = operators test whether both variables point to the same object. Objects will be covered later in the tutorial, in the "Classes, Objects, and Types" 
module. 



Boolean operators 


The Java boolean operators are based on the operations of the boolean algebra. The boolean operators operate directly on boolean values. 
Here is a list of four common boolean operators in Java: 

■ ! : Boolean NOT 

■ && : Boolean AND 

■ I I : Boolean inclusive OR 

■ A : Boolean exclusive XOR 


The boolean NOT operator ("!") inverts the value of a boolean expression. The boolean AND operator ("&&") will result in true if and only if the values on both sides of the 
operator are true. The boolean inclusive OR operator ("II") will result in true if either or both of the values on the sides of the operator is true. The boolean exclusive XOR operator 
(" A ") will result in true if one and only of the values on the sides of the operator is true. 

To show how these operators are used, here is an example: 



Code section 3.38: Operands. 


1 boolean lMTrue = true; 

2 boolean iMTrueToo = true; 

3 boolean iMFalse = faise; 


1 4 boolean iMFalseToo 

! 5 

, 6 System. out . println ( 
■ 7 System. out . println ( 
i 8 System. out . printin ( 

I 9 System. out . printin ( 
ilO System . out . printin ( 

II System. out . printin ( 

'12 System . out . print ln ( 
,13 System . out . print ln ( 
■14 System . out . print ln ( 
il5 System . out . print ln ( 
[16 System . out . printin ( 
>17 System . out . printin ( 
,18 System . out . printin ( 
■19 System . out . printin ( 
i20 System . out . printin ( 
'21 System . out . print in ( 
i22 System . out . print in ( 
,23 System . out . print in ( 
■24 System . out . printin ( 
I__ 


= faise; 

"NOT Operand:"); 

!iMTrue); 

!iMFalse); 

! (4 < 5) ) ; 

"AND Operand:"); 
iMTrue && iMTrueToo); 
iMFalse && iMFalseToo); 
iMTrue && iMFalse); 
iMTrue && !iMFalse); 

"OR Operand:" ); 
iMTrue || iMTrueToo); 
iMFalse || iMFalseToo); 
iMTrue || iMFalse); 
iMFalse || !iMTrue); 

"XOR Operand:"); 
iMTrue A iMTrueToo); 
iMFalse A iMFalseToo); 
iMTrue A iMFalse); 
iMFalse A !iMTrue); 


Output for code section 3.38 


iNOT Operand: 
if alse 
itrue 
if alse 

iAND Operand: 
itrue 
if alse 
if alse 
itrue 

iOR Operand: 
itrue 
if alse 
itrue 
if alse 

iXOR Operand: 
if alse 
if alse 
itrue 
if alse 

L_- 


Here are the truth tables for the boolean operators: 
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a 

!a 

true 

false 

false 

true 


a 

b 

a && b 

a II b 

a A b 

true 

true 

true 

true 

false 

true 

false 

false 

true 

true 

false 

true 

false 

true 

true 

false 

false 

false 

false 

false 


For help on simplifying complex logic, see De Morgan's laws. 


In Java, boolean logic has a useful property called short circuiting. This means that expressions will only be evaluated as far as necessary. In the expression (a && b) , if a is false, 
then b will not be evaluated because the expression will be false no matter what. Here is an example that shows that the second expression is not automatically checked: 



Code section 3.39: Short circuiting. 

1 -1 

|1 System. out .printin ((4 < 5) || ((10 / 0) == 2) ) ; i 

1_i 



Output for code section 3.39 


1 


it rue 

L_ 


To disable this property, you can use & instead of & & and | instead of | | but it's not recommended. 
For the bitwise operations on & and /, see Arithmetic expressions. 


Variables 


In the Java programming language, the words field and variable are both one and the same thing. Variables are devices that are used to störe data, such as a number, or a string of 
character data. 


Variables in Java programming 

Java is considered as a strongly typed programming language. Thus all variables in the Java programming language ought to have a particular data type. This is either declared or 
inferred and the Java language only allows programs to run if they adhere to type constraints. 

If you present a numeric type with data that is not numeric, say textual content, then such declarations would violate Java’s type System. This gives Java the ability of type safety. 
Java checks if an expression or data is encountered with an incorrect type or none at all. It then automatically flags this occurrence as an error at compile time. Most type-related 
errors are caught by the Java Compiler, hence making a program more secure and safe once compiled completely and successfully. Some languages (such as C) define an 
interpretation of such a Statement and use that interpretation without any warning; others (such as PL/I) define a conversion for almost all such Statements and perform the 
conversion to complete the assignment. Some type errors can still occur at runtime because Java supports a cast Operation which is a way of changing the type of one expression to 
another. However, Java performs run time type checking when doing such casts, so an incorrect type cast will cause a runtime exception rather than succeeding silently and allowing 
data corruption. 

On the other hand, Java is also known as a hybrid language. While supporting object oriented programming (OOP), Java is not a pure OO language like Smalltalk or Ruby. Instead, 
Java offers both object types and primitive types. Primitive types are used for boolean, character, and numeric values and operations. This allows relatively good performance when 
manipulating numeric data, at the expense of flexibility. For example, you cannot subclass the primitive types and add new operations to them. 

Kinds of variables 


In the Java programming language, there are four kinds of variables. 


Code listing 3.9: 


ClassWithVariables.java 


;-n 

11 public dass ClassWithVariables { 1 

1 2 public int id = 0; 1 

13 public static boolean isClassUsed; 1 

h ' 

15 public void processData (String parameter) { 1 

16 Object currentValue = null; 1 

\i } ; 

■8 } ; 

L_! 


In the code listing 3.9, are examples of all four kinds of variables. 

■ Instance variables: These are variables that are used to störe the state of an object (for example, id). Every object created from a dass definition would have its own copy of 
the variable. It is valid for and occupies storage for as long as the corresponding object is in memory. 

■ Class variables: These variables are explicitly defined within the class-level scope with a static modifier (for example, isClassUsed). No other variables can have a 
static modifier attached to them. Because these variables are defined with the static modifier, there would always be a single copy of these variables no matter how many 
times the class has been instantiated. They live as long as the class is loaded in memory. 

■ Parameters or Arguments: These are variables passed into a method signature (for example, parameter). Recall the usage of the args variable in the main method. They 
are not attached to modifiers (i.e. public, private, protected or static) and they can be used everywhere in the method. They are in memory during the execution of the 
method and can’t be used after the method returns. 

■ Local variables: These variables are defined and used specifically within the method-level scope (for example, currentValue) but not in the method signature. They do not 
have any modifiers attached to it. They no longer exist after the method has returned. 


Test your knowledge 

Question 3.5: Consider the following code: 
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Question 3.5: SomeClass.java 

;-l 

i 1 public dass SomeClass { 1 

i 2 public static int c = 1; 1 

i 3 public int a = c; 1 

i 4 private int b; 1 

! 5 1 

i 6 public void someMethod (int d) {■ 

i 7 d = c; 1 

i 8 int e; 1 

! 9 } ; 

!io } ■ 


In the example above, we created five variables: a, b, c, d and e. All these variables have the same data type int (integer). However, can you teil what kind of variable each one 
is? 


Answer 

■ a and b are instance variables; 

■ c is a dass variable; 

■ d is a parameter or argument; and, 

■ e is a local variable. 


Creating variables 

Variables and all the information they störe are kept in the computer's memory for access. Think of a computer’s memory as a 
table of data — where each cell corresponds to a variable. 

Upon creating a variable, we basically create a new address space and give it a unique name. Java goes one Step further and lets 
you define what you can place within the variable — in Java parlance you call this a data type. So, you essentially have to do 
two things in Order to create a variable: 

■ Create a variable by giving it a unique name; and, 

■ Define a data type for the variable. 

The following code demonstrates how a simple variable can be created. This process is known as variable declaration. 


Code section 3.40: A simple variable declaration. 


|1 int a; 

l_ 


Assigning values to variables 

Because we have provided a data type for the variable, we have a hint as to what the variable can and cannot hold. We know that int (integer) data type Supports numbers that are 
either positive or negative integers. Therefore once a variable is created, we can provide it with any integer value using the following syntax. This process is called an assignment 
Operation. 

Code section 3.41: Variable declaration and assignment Operation (on different lines). 


,1 int a; 

[2 a = 10; 

l__ 




A computer’s memory is much 
like a room to stuff in Stacks of 
boxes to be filled with 
things. But, a more 
direct and linear 
way of looking at 
memory would be 
to envision it as a 
table of inter-connected cells. 
These cells can be either allocated to be filled at a 
later time, or 
might contain a 
value within. 

Rest of the mem¬ 
ory stays unused. 




A graphical representation of Computer memory 


Java provides programmers with a simpler way of combining both variable declaration and assignment Operation in one line. Consider the following code: 

Code section 3.42: Variable declaration and assignment Operation (on the same line). 

■- 1 

|1 int a = 10; i 

I_i 



Grouping variable declarations and assignment operations 


Consider the following code: 



Code section 3.43: Ungrouped declarations. 


■1 int a; 
i2 int b; 

[3 String c; 

■4 a = 10; 

[5 b = 20; 

J6 c = "sorae text"; 


There are various ways by which you can streamline the writing of this code. You can group the declarations of similar data types in one Statement, for instance: 



Code section 3.44: Grouped declarations. 

i-1 

il int a, b; i 

'2 String c; J 

O a = 10; ■ 

|4 b = 20; ! 

■5 c = "some text"; 1 

l_ 1 
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Alternatively, you can further reduce the syntax by doing group declarations and assignments together, as such: 

Code section 3.45: Grouped declarations and assignments. 

j-T 

[l int a = 10,b = 20; i 

■2 String c = "some text"; J 

L_1 


Identifiers 

Although memory spaces have their own addresses — usually a hash number such as 0xcad3, etc. — it is much easier to remember a variable's location in the memory if we can 
give it a recognizable name. Identifiers are the names we give to our variables. You can name your variable anything like avariabie, somevariabie, age, 

someones important Data, etcetera. But notice: none of the names we described here has a space within it. Hence, it is pretty obvious that spaces aren’t allowed in variable names. 
In fact, there are a lot of other things that are not allowed in variable names. The things that are allowed are: 

■ Characters a to z and their lower-case counterparts atoz. 

■ Numbers o to 9. However, numbers should not come at the beginning of a variable's name. 

■ And finally, special characters that include only $ (dollar sign) and _ (underscore). 

Test your knowledge 

Question 3.6: Which of the ones below are proper variable identifiers? 

1. f_name 

2. lastname 

3. someones name 

4. $SomeoneElsesName 

5. 7days 

6. TheAnswerIs42 

Answer 

I can teil you that 3 and 5 are not the right way to do things around here, the rest are proper identifiers. 


Any valid variable names might be correct but they are not always what you should be naming your variables for a few reasons as listed below: 

■ The name of the variable should reflect the value within them. 

■ The identifier should be named following the naming guidelines or conventions for doing so. We will explain that in a bit. 

■ The identifier shouldn’t be a nonsense name like iname, you should always name it properly: lastName is the best way of naming a variable. 


Naming conventions for identifiers 


When naming identifiers, you need to use the following guidelines which ensure that your variables are named accurately. As we discussed earlier, we should always name our 
variables in a way that teils us what they hold. Consider this example: 



Code section 3.46: Unknown process. 


I-T 

il int a = 24; i 

[2 int b = 365; [ 

■3 int c = a * b; 1 

L_I 


Do you know what this program does? Well, it multiplies two values. That much you guessed right. But, do you know what those values are? Exactly, you don’t. Now consider this 
code: 



Code section 3.47: Time conversion. 

I-T 


il int age = 24; i 
,2 int daysInYear = 365; , 
■3 int agelnDays = age * daysInYear; 1 

L_I 


Now you can teil what's happening, can’t you? However, before we continue, notice the case of the variables. If a word contains CAPITAL LETTERS, it is in UPPER CASE. If a 
word has small letters, it is in lower case. Both cases in a word renders it as mlxEd CaSe. 

The variables we studied so far had a mixed case. When there are two or more words making up the names of a variable, you need to use a special case called the camel-case. Just 
like the humps of a camel, your words need to stand out. Using this technique, the words first and name could be written as either firstName or FirstName. 

The first instance, f irstName is what we use as the names of variables. Remember though, f irstName is not the same as FirstName because Java is case-sensitive. Case-sensitive 
basically implies that the case in which you wrote one word is the case you have to call that word in when using them later on. Anything other than that is not the same as you 
intended. You’ll know more as you progress. You can hopefully teil now why the variables you were asked to identify weren’t proper. 


Literais (values) 


Now that we know how variables should be named, let us look at the values of those variables. Simple values like numbers are called literals. This section shows you what literals 
are and how to use them. Consider the following code: 



Code section 3.48: Literals. 

\ -, 

[l int age = 24; i 

■2 long bankBalance = 20000005L;] 

i_! 


By now, we've only seen how numbers work in assignment Statements. Let's look at data types other than numbers. Characters are basically letters of the English alphabet. When 
writing a single character, we use single quotes to encapsulate them. Take a look at the code below: 
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Code section 3.49: Character. 
■- 1 


|1 char c = ' a ' ; 

l_ 


Why, you ask? Well, the explanation is simple. If written without quotes, the System would think it's a variable identifier. That's the very distinction you have to make when 
differentiating between variables and their literal values. Character data types are a bit unusual. First, they can only hold a single character. What if you had to störe a complete 
name within them, say John , would you write something like: 

Code section 3.50: Character list. 


’l char firstChar = ’J’; 
i2 char secondChar = 1 o 1 ; 

[3 char thirdChar = ’h’; 

■4 char fourthChar = ’n’; 



Now, that's pathetic. Thankfully, there's a data type that handles large number of characters, it's called a string. A string can be initialized as follows: 


Code section 3.51: String. 


■1 String name = "John"; 


Notice, the use of double quotation marks instead of single quotation marks. That's the only thing you need to worry about. 


Primitive Types 


Primitive types are the most basic data types available within the Java language; these include boolean, byte, char, short, int, long, float and double. These types serve as the 
building blocks of data manipulation in Java. Such types serve only one purpose — containing pure, simple values of a kind. Because these data types are defined into the Java type 
System by default, they come with a number of operations predefined. You can not define a new Operation for such primitive types. In the Java type System, there are three further 
categories of primitives: 

■ Numeric primitives: short, int, long, float and double. These primitive data types hold only numeric data. Operations associated with such data types are those of simple 
arithmetic (addition, subtraction, etc.) or of comparisons (is greater than, is equal to, etc.) 

■ Textual primitives: byte and char. These primitive data types hold characters (that can be Unicode alphabets or even numbers). Operations associated with such types are 
those of textual manipulation (comparing two words, joining characters to make words, etc.). However, byte and char can also support arithmetic operations. 

■ Boolean and null primitives: boolean and null. 

All the primitive types have a fixed size. Thus, the primitive types are limited to a ränge of values. A smaller primitive type (byte) can contain less values than a bigger one (long). 


Category 

Types 

Size (bits) 

Minimum Value 

Maximum Value 

Precision 

Example 

Integer 

byte 

8 

-128 

127 

From +127 to -128 

byte b = 65; 

char 

16 

0 

2 16 -1 

All Unicode characters 

char c = 'A'; 

char c = 65; 

short 

16 

-2 15 

2 15 -1 

From +32,767 to -32,768 

short s = 65; 

int 

32 

-2 31 

2 31 -1 

From +2,147,483,647 to -2,147,483,648 

int i = 65; 

long 

64 

-2 63 

2 63 -l 

From +9,223,372,036,854,775,807 to -9,223,372,036,854,775,808 

long 1 = 65L; 

Floating-point 

float 

32 

2~ 149 

(2-2~ 23 )-2 127 

From 3.402,823,5 E+38 to 1.4 E-45 

float f = 65f; 

double 

64 

2-1074 

(2-2' 52 )-2 1023 

From 1.797,693,134,862,315,7 E+308 to 4.9 E-324 

double d = 65.55; 

Other 

boolean 

1 

— 

— 

false, true 

boolean b = true; 

void 

— 

— 

— 

— 

— 


Integer primitive types silently overflow: 



Code section 3.52: Several operators. 

i-1 


!l int i = Integer,MAX_VALUE; 

[2 System . out . print ln (i ) ; 

■3 i = i + 1 ; 

[4 System. out .printin (i) ; 

■5 System. out .printin(Integer. MIN_VALUE ); 

I__ 


Console for Code section 3.52 


2147483647 

-2147483648 

-2147483648 


As Java is strongly typed, you can’t assign a floating point number (a number with a decimal point) to an integer variable: 

A Code section 3.53: Setting a floating point number as a value to an int (integer) type. 

;- 1 

,1 int age; i 

■2 age = 10.5; [ 


A primitive type should be set by an appropriate value. The primitive types can be initialized with a literal. Most of the literals are primitive type values, except String Literais, 
which are instance of the string dass. 

Numbers in Computer Science 

Programming may not be as trivial or boring as just crunching huge numbers any more. However, huge chunks of code written in any programming language today, let alone Java, 
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obsessively deal with numbers. Be it churning out huge prime numbers,^ or just calculating a cost of emission from your scooter. In 1965, Gemini V space mission escaped a 
near-fatal accident because of a programming errorJ 2 ! And again in 1979, a Computer program calculated the ability of five nuclear reactors to withstand earthquakes as 
overestimated; this caused the plants to be shut down temporarilyJ 3 ! There is one thing common to both these programming errors: the subject data, being computed at the time the 
errors occurred, was numeric. Out of past experience, Java came bundled with revised type checking for numeric data and puts lots of emphasis on correctly identifying different 
types of it. So you must recognise the importance of numeric data when it comes to programming. 

Numbers are stored in memory using a binary System. The memory is like a grid of cells: 


Each cell can contain a binary digit (shortened to bit), that is to say, zero or one: 


0 

\— 1 

\— 1 

0 

0 

\— 1 

1 — 1 

0 

1—1 
1 


Actually, each cell does contain a binary digit, as one bit is roughly equivalent to l and an empty cell in the memory signifies o. A single binary digit can only hold two possible 
values: a zero or a one. 


Memory state Value 









0 








1 


Multiple bits held together can hold multiple permutations — 2 bits can hold 4 possible values, 3 can hold 8, and so on. For instance, the maximum number 8 bits can hold 
(llimii in binary) is 2 55 in the decimal System. So, the numbers from 0 to 255 can fit within 8 bits. 


Memory state Value 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

0 

1 

1 


1 

1 

1 

1 

1 

1 

1 

1 


0 

1 

2 

3 


255 


It is all good, but this way, we can only host positive numbers (or unsigned integers). They are called unsigned integers. Unsigned integers are whole number values that are all 
positive and do not attribute to negative values. For this very reason, we would ask one of the 8 bits to hold information about the sign of the number (positive or negative). This 
leaves us with just 7 bits to actually count out a number. The maximum number that these 7 bits can hold (liinii) is 127 in the decimal System. 


Positive numbers 

Memory state Value 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

1 

1 


1 

1 

1 

1 

1 

1 

1 


Negative numbers 

Memory state Value 


1 

0 

0 

0 

0 

0 

0 

0 

-128 

1 

0 

0 

0 

0 

0 

0 

1 

-127 

1 

0 

0 

0 

0 

0 

1 

0 

-126 

1 

0 

0 

0 

0 

0 

1 

1 

-125 



... 

1 

1 

1 

1 

1 

1 

1 

1 

-1 


Altogether, using this method, 8 bits can hold numbers ranging from - i28toi27 (including zero) — a total of 256 numbers. Not a bad pay-off one might presume. The opposite to 
an unsigned integer is a signed integer that have the capability of holding both positive and negative values. 

But, what about larger numbers. You would need significantly more bits to hold larger numbers. That's where Java's numeric types come into play. Java has multiple numeric types 
— their size dependant on the number of bits that are at play. 

In Java, numbers are dealt with using data types specially formulated to host numeric data. But before we dive into these types, we must first set some concepts in stone. Just like 
you did in high school (or even primary school), numbers in Java are placed in clearly distinct groups and Systems. As you’d already know by now, number Systems includes groups 
like the integer numbers (0, 1, 2 ... oo); negative integers (0, -1, -2 ... -oo) or even real and rational numbers (value of Pi, %, 0.333-, etcetera). Java simply tends to place these 
numbers in two distinct groups, integers (-oo ... 0 ... oo) and floating point numbers (any number with decimal points or fractional representation). For the moment, we would only 
look into integer values as they are easier to understand and work with. 


Integer types in Java 

With what we have learned so far, we will identify the different types of signed integer values that can be created and manipulated in Java. Following is a table of the most basic 
numeric types: integers. As we have discussed earlier, the data types in Java for integers caters to both positive and negative values and hence are signed numeric types. The size in 
bits for a numeric type determines what its minimum and maximum value would be. If in doubt, one can always calculate these values. 

Fets see how this new found knowledge of the basic integer types in Java fits into the picture. Say, you want to numerically manipulate the days in a year — all 365 days. What type 

would you use? Since the data type byte only goes up to 127, would you risk giving it a value greater than its allowed maximum. Such decisions might save you from dreaded errors 
that might occur out of the programmed Code. A much more sensible choice for such a numeric Operation might be a short. Oh, why couldn’t they make just one data type to hold 
all kinds of numbers? Wouldn’t you ask that question? Well, let's explore why. 

When you teil a program you need to use an integer, say even a byte, the Java program allocates a space in the memory. It allocates whole 8 bits of memory. Where it wouldn’t 
seem to matter for today’s memory modules that have place for almost a dozen trillion such bits, it matters in other cases. Once allocated that part of the memory gets used and can 
only be claimed back after the Operation is finished. Consider a complicated Java program where the only data type you’d be using would be long integers. What happens when 
there’s no space for more memory allocation jobs? Ever heard of the Stack Overflow errors. That's exactly what happens — your memory gets completely used up and fast. So, 
choose your data types with extreme caution. 

Enough talk, let’s see how you can create a numeric type. A numeric type begins with the type’s name (short, int, etc.) and then provides with a name for the allocated space in 

the memory. Following is how it's done. Say, we need to create a variable to hold the number of days in a year. 
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Code section 3.54: Days in a year. 

1 -T 


|1 short daysInYear = 365; 

L_ 


Here, daysinYear is the name of the variable that holds 365 as it's value, while short is the data type for that particular value. Other uses of integer data types in Java might see 
you write Code such as this given below: 



Code section 3.55: Integer data types in Java. 
-! 


[1 byte maxByte = 127; 
i2 short maxShort = 32767; 

[3 int maxint = 2147483647; 

■4 long maxLong = 9223372036854775807; 


L 


Integer numbers and floating point numbers 

The data types that one can use for integer numbers are byte, short, int and long but when it comes to floating point numbers, we use f loat or double. Now that we know that, 
we can modify the code in the code section 3.53 as: 

Code section 3.56: Correct floating point declaration and assignment. 


|1 double age = 10.5; 


Why not f loat, you say? If we'd used a f loat, we would have to append the number with a f as a suffix, so 10.5 should be 10 .5f as in: 

Code section 3.57: The correct way to define floating point numbers of type fioat. 


|1 fioat age = 10.5f; 




Floating-point math never throws exceptions. Dividing a non-zero value by o equals 


infinity. Dividing a non-infinite value by 


infinity equals 0. 


Test your knowledge 

Question 3.7: Consider the following code: 




Question 3.7: Primitive type assignments. 


5 



6 



7 

a = 

false ; 

8 

b = 

3.2; 

9 

c = 

35; 

10 

d = 

-93485L; 

11 

e = 

’q’; 


These are five variables. There are a long, a byte, a char, a double and a boolean. Retrieve the type of each one. 
Answer 

Answer 3.7: Primitive type assignments and declarations. 




1 boolean a; 

2 double b; 

3 byte c; 

4 long d; 

5 char e; 

6 

7 a = false ; 

8 b = 3.2; 

9 c = 35; 

10 d = -93485L; 

q’; 


a can only be the boolean because only a boolean can handle boolean values. 
e can only be the char because only a char can contain a character. 
b can only be the double because only a double can contain a decimal number here. 
d is the long because a byte can not contain such a low value. 
c is the remaining one so it is the byte. 


Data conversion (casting) 


Data conversion (casting) can happen between two primitive types. There are two kinds of casting: 

■ Implicit: casting Operation is not required; the magnitude of the numeric value is always preserved. However, precision may be lost when Converting from integer to floating 
point types 

■ Explicit: casting Operation required; the magnitude of the numeric value may not be preserved 



Code section 3.58: Implicit casting (int is converted to long, casting is not needed). 

I-1 

il int i = 65; i 

,2 long 1 = i; 8 


L 
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Code section 3.59: Explicit casting (long is converted to int, casting is needed). 

I-I 

i i 

il long 1 = 656666L; i 

[2 int i = (int) 1; | 

1 1 

1 1 

l- 1 

The following table shows the conversions between primitive types, it shows the casting Operation for explicit conversions: 



from byte 

from char 

from short 

from int 

from long 

from float 

from double 

from boolean 

to byte 

- 

(byte) 

(byte) 

(byte) 

(byte) 

(byte) 

(byte) 

N/A 

to char 


- 

(char) 

(char) 

(char) 

(char) 

(char) 

N/A 

to short 


(short) 

- 

(short) 

(short) 

(short) 

(short) 

N/A 

to int 




- 

(int) 

(int) 

(int) 

N/A 

to long 





- 

(long) 

(long) 

N/A 

to float 






- 

(float) 

N/A 

to double 







- 

N/A 

to boolean 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

- 


Unlike C, C++ and similar languages, Java can’t represent faise as 0 or null and can’t represent true as non-zero. Java can't cast from boolean to a non-boolean primitive data 
type, or vice versa. 



For non primitive types: 



to Integer 

to Float 

to Double 

to String 

to Array 

Integer 

- 

(float)x 

(double)x 

x.doubleValueO 

x.toStringO 

Float.toString(x) 

new int[] {x} 

Float 

java.text.DecimalFormat("#").format(x) 

- 

(double)x 

x.toStringO 

new float[] {x} 

Double 

j ava.text.DecimalFormatf "#") .format(x) 

j ava.text.DecimalFormatf "#") .format(x) 

- 

x.toStringO 

new double[] {x} 

String 

Integer.parselnt(x) 

Float.parseFloat(x) 

Double .parseDouble (x) 

- 

new Stringf] {x} 

Array 

x[0] 

x[0] 

x[0] 

Arrays.toString(x) 

- 


Notes 

1. As of edit (11 December 2013), the Great Internet Mersenne 
Prime Search project has so far identified the largest prime 
number as being 17,425,170 digits long. Prime numbers are 
valuable to cryptologists as the bigger the number, the securer 
they can make their data encryption logic using that particular 
number. 


2. Gemini 5 landed 130 kilometers short of its planned Pacific 
Ocean landing point due to a Software error. The Earth's 
rotation rate had been programmed as one revolution per solar 
day instead of the correct value, one revolution per sidereal 
day. 

3. A program used in their design used an arithmetic sum of 


variables when it should have used the sum of their absolute 
values. (Evars Witt, "The Little Computer and the Big 
Problem ", AP Newswire, 16 March 1979. See also Peter 
Neumann, "An Editorial on Software Correctness and the 
Social Process" Software Engineering Notes, Volume 4(2), 
April 1979, page 3) 


Arithmetic expressions 

In order to do arithmetic in Java, one must first declare at least one variable. Typically one declares a variable and assigns it a value before any arithmetic is done. Here's an example 
of declaring an integer variable: 

Code section 3.59: Variable assignation. 

| -, 

■1 int x = 5; i 

l_I 


After creating a variable, one can manipulate its value by using Java’s operators: + (addition), - (subtraction), * (multiplication), / (integer division), % (modulo or remainder), ++ 
(pre- & postincrement by one), — (pre- & postdecrement by one). 


Code listing 3.10: Operators.java 

m 

Console for Code listing 3.10 

i 

public dass Operators { 




x = 5 

2 

public static void main (String[] args) { 





3 

int x = 5; 




- Addition - 

4 

System. out . printin ( "x = " + x); 




x + 2 = 7 

5 

£ 

System. out . println () ; 




x = 5 

7 

System. out . println ( "- Addition 




- Subtraction - 

8 

x = 5; 




x - 4 = 1 

9 

System. out . println ("x + 2 = " + (x + 2)); 




x = 5 

10 

System. out . printin ( "x = " + x); 





11 

System. out . println () ; 




- Multiplication - 

12 





x * 3 = 15 

13 

System.out. printin ("- Subtraction 

; 



x = 5 

14 

x = 5; 





15 

System. out . println ( "x - 4 = " + (x - 4)); 




- (Integer) Division - 

16 

System. out . printin ( "x = " + x); 




x / 2 = 2 

17 

System.out. printin (); 




x = 5 

18 






19 

System.out .printin ("- Multiplication 

-") ; 



- Modulo (Remainder) - 

20 

x = 5; 




x % 2 = 1 


System. out . println ( "x * 3 = " + (x * 3)); 
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21 22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 } 
61 } 


System. out . printin ( "x = " + x); 

System. out .printin () ; 

System. out . printin ( "- (Integer) Division - "); 

x = 5; 

System. out . printin ( "x / 2 = " + (x/2)); 

System.out .printin ( "x = " + x); 

System. out . println () ; 

System. out . printin ( "- Modulo (Remainder) - "); 

x = 5; 

System. out . printin ( "x % 2 = " + (x % 2)); 

System. out . printin ( "x = " + x); 

System. out . println () ; 

System. out . println ( "-Preincrement by one - "); 

x = 5; 

System.out .printin ( "++x = " + (++x )); 

System. out . printin ( "x = " + x); 

System. out . println () ; 


System.out.printin ("- 

x = 5 ; 

System.out.printin ("—x 
System. out . println ("x = 
System.out.printin () ; 

System.out.printin ("- 

x = 5 ; 

System.out.printin ("x++ 
System.out.printin( "x = 
System.out.printin () ; 

System.out.printin ("- 

x = 5 ; 

System.out.printin ("x— 
System. out . println ("x = 
System.out.printin () ; 


Predecrement by one - "); 

= " + (--x )); 

" + x) ; 

Postincrement by one - "); 

= " + (x++ )); 

" + x) ; 

Postdecrement by one - "); 

= " + (x ) ) ; 

" + x) ; 


ix = 5 

i-Preincrement by one - 

i++x = 6 
ix = 6 

i-Predecrement by one - 

!—x = 4 
!x = 4 

i-Postincrement by one- 

ix + + = 5 

ix = 6 

i-Postdecrement by one- 

ix = 5 

ix = 4 

I__ 


The division operator rounds towards zero: 5/2 is 2, and -5/2 is -2. The remainder operator has the same sign as the left Operand; it is defined such that ( (a/b) *b) + (a%b) is 
always equal to a. The preincrement, predecrement, postincrement, and postdecrement operators are special: they also change the value of the variable, by adding or subtracting 
one. The only difference is that preincrement/decrement returns the new value of the variable; postincrement returns the original value of the variable. 

Test your knowledge 

Question 3.8: Consider the following code: 


Question 3.8: Question8.java 


1 public dass Question8 { 


2 

3 

4 

5 

6 

7 

8 
9 

ilO } 

i 

I_ 


public static void main (String[] args) { 
int x = 10; 
x = x + 10; 
x = 2 * x; 
x = x - 19; 
x = x / 3 ; 

System. out .printin (x); 

} 


What will be printed in the Standard output? 


Answer 


□ 


Output for Question 3.8 


int x = 10; => 10 
x = x + 10; => 20 

x = 2 * x; => 40 

x = x - 19; => 21 
x = x / 3; => 7 


When using several operators in the same expression, one must consider Java's Order of precedence. Java uses the Standard PEMDAS (Parenthesis, Exponents, Multiplication and 
Division, Addition and Subtraction) Order. When there are multiple instances of the same precedence, Java reads from left to right. Consider what the output of the following code 
would be: 



Code section 3.60: Several operators. 

■-1 

■1 System. out .printin (10*5 + 100/10 - 5 + 7%2) ; i 

I_i 


□I 


Console for Code section 3.60 


i5 6 


The following chart shows how Java would compute this expression: 
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Figure 3.1: Computation of an arithmetic expression in the Java programming language 



T 


55 + 1 


Besides performing mathematical functions, there are also operators to assign numbers to variables (each example again uses the variable initialized asx = 5): 


Code listing 3.11: Assignments.java 


1 public dass Assignments { 

2 public static void main (String[] args) { 

3 int x = 5; 
x = 3 ; 

System.out .printin ( "Assignment 


a 


(X = 3) : " + x) • 


(x += 5) : " + x) f 


(x -= 4) : " + x) ' 


7 x = 5; 

8 x += 5; 

9 System. out . println ( "Assign x plus another integer to itself 

ilO 

!ll x = 5; 

!l 2 x -= 4; 

il3 System. out . println ( "Assign x minus another integer to itself 

!l 4 

!l 5 x = 5; 

il 6 x *= 6; 

il7 System. out . println ( "Assign x multiplied by another integer to itself (x *= 6): " + x )f 

Il 8 

11 9 x = 5; 

12 0 x /= 5; 

121 System. out . println ( "Assign x divided by another integer to itself (x /= 5): " + x )! 

122 } 

1 23 } 


Console for Code listing 3.11 

lAssignment (x = 3) : 3 

■Assign x plus another integer to itself (x += 5): 10 

lAssign x minus another integer to itself (x -= 4): 1 

■Assign x multiplied by another integer to itself (x *= 6): 30 

■Assign x divided by another integer to itself (x /= 5): 1 


Using bitwise operators within Java 

Java has besides arithmetic operators a set of bit operators to manipulate the bits in a number, and a set of logical operators. The bitwise logical operators are 


Operator 

Function 

Value of 

x before 

Example 

input 

Example 

output 

Value of 

x after 

& 

Bitwise AND 

7 

x& 2 7 

3 

7 

1 

Bitwise OR 

7 

x | 27 

31 

7 

A 

Bitwise XOR 

7 

x A 27 

28 

7 

~ 

Bitwise inversion 

7 

~x 

-8 

7 


Besides these logical bitwise functions, there are also operators to assign numbers to variables (x = - 5 ): 


Operator 

Function 

Example 

input 

Example output 

&= 

Assign x bitwisely ANDed with another value to itself 

X &= 3 

3 

1 = 

Assign x bitwisely ORed with another value to itself 

x 1= 3 

-5 

A_ 

Assign x bitwisely XORed with another value to itself 

x A = 3 

-8 

<<= 

Assign x divided by another integer to itself 

x <<= 1 

-10 

>>= 

Assign x bitwisely negated with another value to itself 

x >>= 1 

-3 

>>>= 

Assign x bitwisely negated with another value to itself 

X >>>= 1 

2,305,843,009,213,693,949 (64 bit) 


The shift operators are used to shift the bits to the left or right, which is also a quick way to multiply/divide by two: 


Operator 

Function 

Value of 

x before 

Example 

input 

Example output 

Value of 

x after 

<< 

Logical shift left 

-15 

X << 2 

-60 

-15 

>> 

Arithmetic shift right 

-15 

x >> 3 

-2 

-15 

>>> 

Logical shift right 

-15 

x >>> 3 

2,305,843,009,213,693,937 (64 bit) 

-15 


Literais 
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Java Literais are syntactic representations of boolean, character, numeric, or string data. Literais provide a means of expressing specific values in your program. For example, in the 
following Statement, an integer variable named count is declared and assigned an integer value. The literal 0 represents, naturally enough, the value zero. 



Code section 3.61: Numeric literal. 

1 -1 

|1 int count = 0; i 

l_i 


The code section 3.62 contains two number literals followed by two boolean literals at line 1, one string literal followed by one number literal at line 2, and one string literal followed 
by one real number literal at line 3: 



Code section 3.62: Literals. 


il (2 > 3) ? true : false; i 

[2 "text" . substring (2 ) ; [ 

■3 System. out . printin ( "Display a hard coded float: " + 37.19f);‘ 

l_i 


Boolean Literals 

There are two boolean literals 

■ true represents a true boolean value 

■ false represents a false boolean value 

There are no other boolean literals, because there are no other boolean values! 

Numeric Literals 

There are three types of numeric literals in Java. 

Integer Literals 

In Java, you may enter integer numbers in several formats: 

1. As decimal numbers such as 1995, 51966. Negative decimal numbers such as - 4 2 are actually expressions consisting of the integer literal with the unary negation Operation -. 

2. As octal numbers, using a leading o (zero) digit and one or more additional octal digits (digits between o and 7), such as 077. Octal numbers may evaluate to negative 
numbers; for example 037777777770 is actually the decimal value -8. 

3. As hexadecimal numbers, using the form 0 x (or ox) followed by one or more hexadecimal digits (digits from o to 9 , a to f or a to f). For example, OxCAFEBABEL is the long 
integer 3405691582. Like octal numbers, hexadecimal literals may represent negative numbers. 

4. Starting in J2SE 7.0, as binary numbers, using the form Ob (or ob) followed by one or more binary digits (0 or 1). For example, OblOlOlO is the integer 42. Like octal and hex 
numbers, binary literals may represent negative numbers. 

By default, the integer literal primitive type is int. If you want a long, add a letter el suffix (either the character l or the character l) to the integer literal. This suffix denotes a long 
integer rather than a Standard integer. For example, 340569i582Lisa long integer literal. Long integers are 8 bytes in length as opposed to the Standard 4 bytes for int. It is best 
practice to use the suffix l instead of l to avoid confusion with the digit l (one) which looks like l in many fonts: 2001 ^ 2001 . If you want a short integer literal, you have to cast 
it. 

Starting in J2SE 7.0, you may insert underscores between digits in a numeric literal. They are ignored but may help readability by allowing the programmer to group digits. 

Floating Point Literals 

Floating point numbers are expressed as decimal fractions or as exponential notation: 

^ Code section 3.63: Floating point literals. 

;-1 

,1 double decimalNumber =5.0; i 

■2 decimalNumber = 5d; , 

i3 decimalNumber = 0.5; 1 

[4 decimalNumber = lOf; i 

■5 decimalNumber = 3.14159e0; 1 

[6 decimalNumber = 2.718281828459045D; i 

■7 decimalNumber = 1 . 0e-6D; 

I_ 1 


Floating point numbers consist of: 

1. an optional leading + or - sign, indicating a positive or negative value; if omitted, the value is positive, 

2. one of the following number formats 

■ integer digits (must be followed by either an exponent or a suffix or both, to distinguish it from an integer literal) 

■ integer digits . 

■ integer digits . integer digits 

■ . integer digits 

3. an optional exponent of the form 

■ the exponent indicator e or e 

■ an optional exponent sign + or - (the default being a positive exponent) 

■ integer digits representing the integer exponent value 

4. an optional floating point suffix: 

■ either f or f indicating a single precision (4 bytes) floating point number, or 

■ d or d indicating the number is a double precision floating point number (by default, thus the double precision (8 bytes) is default). 

Here, integer digits represents one or more of the digits o through 9. 

Starting in J2SE 7.0, you may insert underscores between digits in a numeric literal. They are ignored but may help readability by allowing the programmer to group digits. 

Character Literals 

Character literals are constant valued character expressions embedded in a Java program. Java characters are sixteen bit Unicode characters, ranging from 0 to 65535. Character 
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literals are expressed in Java as a single quote, the character, and a closing single quote ( ' a ' , ' 7 ' , ' n ' )• Character literals have the type char, an unsigned integer primitive 

type. Character literals may be safely promoted to larger integer types such as int and long. Character literals used where a short or byte is called for must be cast to short or 
byte since truncation may occur. 


String Literals 


String literals consist of the double quote character (") (ASCII 34, hex 0x22), zero or more characters (including Unicode characters), followed by a terminating double quote 
character ("), such as: "Ceci est une string." 


So a string literal follows the following grammar: 


<STRING : 

fl \ II II 

( (~["\"'\ " \ n " , " \ r " ] ) 

I("\\" 

( ["n", "t", "b", "r", "f", 

| [.. o.. _.. 7 i. ] ( [ " 0 " - " 7 " ] ) ? 

| [ " 0 " - " 3 " ] [ " 0 " - " 7 " ] [ " 0 " - " 7 " ] 
) 

) 

) * 

II \ II I! v. 


Within string and character literals, the backslash character can be used to escape special characters, such as Unicode escape sequences, or the following special characters: 


Name 

Character 

ASCII 

hex 

Backspace 

\b 

8 

0x08 

TAB 

\t 

9 

0x09 

NUL character 

\o 

0 

0x00 

newline 

\n 

10 

0x0a 

carriage control 

\r 

13 

Oxd 

double quote 

\" 

34 

0x22 

single quote 

V 

39 

0x27 

backslash 

w 

92 

0x5 c 


I 


String literals may not contain unescaped newline or linefeed characters. However, the Java Compiler will evaluate compile time expressions, so the following String expression 
results in a string with three lines of text: 



Code section 3.64: Multi-line string. 

i-1 


■1 String text = "This is a String literalXn" i 
[2 + "which spans not one and not two\n"[ 
■3 + "but three lines of text. \n" ; 1 

l_i 


null 


null is a special Java literal which represents a null value : a value which does not refer to any object. It is an error to attempt to dereference the null value — Java will throw a 
NuiiPointerExcept ion. null is often used to represent uninitialized state. 


Mixed Mode Operations 

In concatenation operations, the values in brackets are concatenated first. Then the values are concatenated from the left to the right. Be careful when mixing character literals and 
integers in String concatenation operations: 


9 Code section 3.65: Concatenation operations. 


1 int one = '1'; 

2 int zero = ' 0 ' ; 

3 

4 System. out . print ln ( " 120? " + one + '2' + zero 


L 


□ 


Console for Code section 3.66 


il 2 0 ? 49248 


The unexpected results arise because ' l' and ' o ' are converted twice. The expression is concatenated as such: 


"120? " + one + '2' + zero 

"120? " + 49 + '2' + 48 
" 120 ? 49 " + '2' + 48 
" 120 ? 492 " + 48 
" 120 ? 49248 " 


1. one and zero are integers. So they störe integer values. The integer value of ' l' is 49 and the integer value of ' 0 ' is 48. 

2. So the first concatenation concatenates " 120 ? " and 49. 4 9 is first converted into String, yielding " 49 " and the concatenation re turns the string "12 o? 49 ". 

3. The second concatenation concatenates " 120 ? 49 " and ' 2 ' . ' 2 ' is converted into the String " 2 " and the concatenation returns the string " 120 ? 492 ". 

4. The concatenation between " 120 ? 492 " and ' o ' returns the string " 120 ? 49248 ". 

The code section 66 yields the desired result: 



Code section 3.66: Correct primitive type. 
-! 


1 char one = '1' ; 

2 char zero = '0' ; 

3 

4 System. out . println ( "120? " + one + '2' + zero 



Console for Code section 3.66 


Il20 ? 120 


1 
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Test your knowledge 

Question 3.9: Consider the following code: 


S 


Question 3.9: New concatenation operations. 


,1 int one = ' 1 ' ; 

■2 int zero = ' 0 ' ; 

13 

'4 System. out . printin ( " 3? " + (one + '2' + zero) 

■5 Sy stem . out . pr int ln ( " 10 2 ? " + 100 + '2' + 0); 

[6 System. out . print ln ( "102? " + (100 + '2' + 0)); 




Console for Question 3.9 


3? 147 

il 0 2 ? 10020 

il 0 2 ? 150 

i 

I_! 


Explain the results seen. 


Answer 

For the first line: 





" 3? " + (one 

+ ' 2 ' + 

zero) 


" 3? " + (49 

+ ' 2 ' + 

48 ) 


" 3 ? " + 

(99 + 48 

) 


" 3 ? " 

+ 147 



" 3 ? 

147 " 


For the second line: 





"102? " + 100 + '2' 

+ 0 


" 102 ? 100 " 

+ ' 2 ' + 

0 


" 102 ? 1002 " + 0 



" 102 ? 

10020 " 


For the last line: 





"102? " + (100 + '2' 

+ 0) 


"102? " + 

(150 + C 

') 


"102? " 

1 + 150 



" 102 ? 

150 " 



Methods 


Methods are how we communicate with objects. When we invoke or call a method we are asking the object to carry out a task. We can say methods implement the behaviour of 
objects. For each method we need to give a name, we need to define its input parameters and we need to define its return type. We also need to set its visibility (private, protected or 
public). If the method throws an Exception, that needs to be declared as well. It is called a method definition. The syntax of method definition is: dass MyClass { 


-1 

public ReturnType methodName (ParamOneType parameterl, , 

ParamTwoType parameter2) 1 

throws ExceptionName { i 

ReturnType returnType; 1 

return returnType; ' 

} 1 


} 

We can declare that the method does not return anything using the void Java keyword. For example: 



Code section 3.67: Method without returned data. 
-! 


[l private void methodName (String parameterl, String parameter2) { 

■2 

[3 return; 

■4 } 


L 


When the method returns nothing, the return keyword at the end of the method is optional. When the execution flow reaches the return keyword, the method execution is 
stopped and the execution flow returns to the caller method. The return keyword can be used anywhere in the method as long as there is a way to execute the instructions below: 

A Code section 3.68: return keyword location. 

i-1 

■ ■ 

1 1 private void aMethod(mt a, int b) { i 

1 2 int c = 0; [ 

! 3 if (a > 0) { ' 

[ 4 c = a; ! 

1 5 return; 1 

! 6 } ! 

1 7 int c = c + b; | 

i 8 return; ■ 
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[ 9 int c = c * 2; 
[10 } 

I_ 


In the code section 3.68, the return keyword at line 5 is well placed because the instructions below can be reached when a is negative or equal to 0. However, the return keyword 
at line 8 is badly placed because the instructions below can’t be reached. 

Test your knowledge 

Question 3.9: Consider the following code: 


m 


Question 3.9: Compiler error. 


i 


[l private int myMethod(int a, int b, boolean c) { 
■2 b = b + 2; 

|3 if (a > 0) { 

■4 a = a + b; 

i5 return a; 

[6 } eise { 

■7 a = 0; 


} 


■9 } 


l_ 


The code above will return a Compiler error. Why? 


Answer 




Answer 3.9: Compiler error. 


[l private int myMethod(int a, int b, boolean c) 
■2 b = b + 2; 

[3 if (a > 0) { 

■4 a = a + b; 

i5 return a; 

[6 } eise { 

i7 a = 0; 


} 


■9 } 


1_ 


The method is supposed to return a int but when a is negative or equal to 0, it returns nothing. 


Parameter passing 

We can pass any primitive data types or objects to a method but the two are not processed the same way. 

Primitive type parameter 

The primitive types are passed in by value. It means that as soon as the primitive type is passed in, there is no more link between the value inside the method and the source 
variable: 


m 




Code section 3.69: A method modifying a variable. 


il private void modifyValue ( int number) { 
[2 number += 1; 

■3 } 


Code section 3.70: Parameter by value. 


il int i = 0; 

[2 modifyValue(i); 

■3 System . out . print ln (i ) ; 


□I 


Output for Code section 3.70 


As you can see in code section 3.70, the modif yValue () method has not modified the value of i. 

Object parameter 

The object references are passed by value. It means that: 

■ There is no more link between the reference inside the method and the source reference, 

■ The source object itself and the object itself inside the method are still the same. 

You must understand the difference between the reference of an object and the object itself. A object reference is the link between a variable name and an instance of object: 


Object object <=> new Object () 


An object reference is a pointer, an address to the object instance. 

The object itself is the value of its attributes inside the object instance: 


object.firstName => "James" 
object.lastName => "Gosling" 
object.birthDay => "May 19" 


Take a look at the example above: 



Code section 3.71: A method modifying an object. 
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i-1 

il private void modifyObject (FirstClass anObject) {i 

[2 anObject . setName ("Susan") ; J 

| 3 } 1 

1_1 



Code section 3.72: Parameter by reference. 

■- 1 


■1 FirstClass object = new FirstClass(); 
i2 object . setName ( "Christin" ) ; 

! 3 

i4 modifyObject(object); 

[5 

|6 System. out .printin(object.get Name () ); 

1 _ 


□I 


Output for Code section 3.72 


iSusan 

1 - 


The name has changed because the method has changed the object itself and not the reference. Now take a look at the other example: 



Code section 3.73: A method modifying an object reference. 
-! 


[1 private void modifyObject (FirstClass anObject) { 
i2 anObject = new FirstClass(); 

[3 anObject. setName ( "Susan" ) ; 

■4 } 


L 



Code section 3.74: Parameter by reference. 

I-1 

■1 FirstClass object = new FirstClass(); i 

i2 ob ject . setName ( "Christin" ) ; s 

[3 ' 

■4 modifyOb ject (ob ject) ; i 

[5 | 

|6 System. out . println (object. getName ()); i 

1_1 



Output for Code section 3.74 


iChris t in 


l 


The name has not changed because the method has changed the reference and not the object itself. The behavior is the same as if the method was in-lined and the parameters were 
assigned to new variable names: 


m 


Code section 3.75: In-lined method. 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 


FirstClass object = new FirstClass(); 
object. setName ( "Christin" ); 

// Start of the method 

FirstClass anObject = object; 
anObject = new FirstClass () ; 
anObject. setName ( "Susan") ; 

// End of the method 

System.out.printin(object. getName ()); 


□ 


Output for Code section 3.75 


iChristin 


Variable argument list 

Java SE 5.0 added syntactic support for methods with variable argument list (http://docs.oracle.eom/javase/l.5.0/does/guide/language/varargs.html), which simplifies the typesafe 
usage of methods requiring a variable number of arguments. Less formally, these parameters are called varargs\ 2] (http://www.javabeat.net/qna/645-varargs-in-java-50/). The last 
Parameter can be followed with . . ., and Java will box all the arguments into an array. Vararg parameter must always be the last method parameter: 

Code section 3.76: A method using vararg parameters. 

I-1 

il public void drawPolygon (java. awt . Point ... points) { 1 

[2 //... ; 

■3 } 1 

L-1 



When calling the method, a programmer can simply separate the points by commas, without having to explicitly create an array of Point objects. Within the method, the points can 
be referenced as points [ 0 ], points [ 1 ], etc. If no points are passed, the array has a length of zero. To require the programmer to use a minimum number of parameters, those 
parameters can be specified before the variable argument: 

Code section 3.77: Variable arguments. 

I- n 

1 1 

il // A polygon needs at least three points. 1 

,2 public void drawPolygon (Point pl, Point p2, Point p3, Point... otherPoints) {, 

1 1 

1 1 

L_I 



Return parameter 


So as we can see, a method may or may not return a value. If the method does not return a value we use the void Java keyword. 

Same as the parameter passing, the method can return a primitive type or an object reference. So a method can return only one value. What if you want to return more than one 
value from a method. You can always pass in an object reference to the method, and let the method modify the object properties. The modified values can be considered as an 
output value from the method. However you can also create an Object array inside the method, assign the return values and return the array to the caller. You could have a problem 
however, if you want to mix primitive data types and object references as the output values from the method. 

There is a better approach. Defines special return object with the needed return values. Create that object inside the method, assign the values and return the reference to this 
object. This special object is "bound" to this method and used only for returning values, so do not use a public dass. The best way is to use a nested dass, see example below: 



Code listing 3.12: Multiple returned variables. 


-! 

1 public dass MyObject { 1 

2 ' 

3 1 
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! 4 

/** Nested object is for return values from 

getPersoninfoByid method 

*/, 

1 5 

public static dass ReturnObject { 



! 6 

private int age; 



; 7 

private String name; 



! 8 




| 9 

public void setAge(int age) { 



JlO 

this.age = age; 



[11 

} 



[l 2 




Il3 

public int getAge ( ) { 



[l 4 

return age; 



Il 5 

} 



Jl 6 




Il 7 

public void setName (String name) { 



II 8 

name = name; 



Il 9 

} 



12 0 




1 

,21 

public String getName () { 



I 22 

return name; 



1 

,2 3 

} 



',2 4 

} // End of nested dass definition 



1 

,2 5 




I 2 6 

/** Method using the nested dass to return 

values */ 


',21 

public ReturnObject getPersoninfoByid ( int id) { 


I 2 8 

int age; 



12 9 

String name; 



13 0 




hl 

// Get the name and age based on the ID from the database 


132 




13 3 

ReturnObject result = new ReturnObject (); 



13 4 

result. setAge (age) ; 



13 5 

result. setName (name) ; 



13 6 




13 7 

return result; 



13 8 

} 



i3 9 

1 

1- - 

} 


- - 


In the above example the getPersoninfoByid method returns an object reference that contains both values of the name and the age. See below how you may use that object: 


m 


Code section 3.78: Retrieving the values. 


il MyObject object = new MyObject(); 

'2 MyObject. ReturnObject person = object . getPersonlnfoById (102 

>3 

[4 System.out.printin ("Person Name=" + person. getName ()); 

■5 System. out . printin ( "Person Age =" + person.getAge()); 


Test your knowledge 

Question 3.10: Consider the following code: 




Question 3.10: Compiler error. 


il private int myMethod(int a, int b, String c) {i 
[2 if (a > 0) { 

,3 c = ; 

i4 return c; 

! 5 } 

16 int b = b + 2; 

[7 return b; 

| 8 } 

L__ 


The code above will return a Compiler error. Why? 


Answer 


Answer 3.10: Compiler error. 



1- 

11 private int myMethod(int a, int b, String c) 

12 if (a > 0) { 

,3 C = 

1 4 return c; 

1 5 } 

16 int b = b + 2; 

[7 return b; 

I 8 } 

1_ 


The method is supposed to return a int but at line 4 , it returns c, which is a String. 


Special method, the constructor 

The constructor is a special method called automatically when an object is created with the new keyword. Constructor does not have a return value and its name is the same as the 
dass name. Each dass must have a constructor. If we do not define one, the Compiler will create a default so called empty constructor automatically. 


Code listing 3.13: Automatically created constructor. 


11 public dass MyClass { 

12 /** 

13 * MyClass Empty Constructor 

U V 

i5 public MyClass () { 

!ö } 

■7 } 


67 sur 134 


30/01/2016 20:09 























Java Programming/Print Version - Wikibooks, openbooks for an open worldhttps://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


Static methods 

A static method is a method that can be called without an object instance. It can be called on the dass directly. For example, the valueof (String) method of the integer dass is 
a static method: 

Code section 3.79: Static method. 

i“ 

'1 
L . 


Integer i = Integer. valueOf ("10 "); i 



As a consequence, it cannot use the non-static methods of the dass but it can use the static ones. The same way, it cannot use the non-static attributes of the dass but it can use the 
static ones: 

Code section 3.80: Static attribute. 


!l private static int count = 0; 

•2 

■3 public static int getNewInteger () { 

[4 return count++; 

|5 } 



You can notice that when you use System, out .print ln (), out is a static attribute of the System dass. A static attribute is related to a dass, not to any object instance, so there is 
only one value for all the object instances. This attribute is unique in the whole Java Virtual Machine. All the object instances use the same attribute: 


Code listing 3.14: A static attribute. 

;-1 

i 1 public dass MyProgram { 1 

! 2 ' 

i 3 public static int count =0; 1 

! 4 ' 

i 5 public static void main (String[] args) { 1 

i 6 MyProgram . count ++; 1 

! 7 1 

i 8 MyProgram programl = new MyProgram(); 1 

i 9 programl. count ++; 1 

!io ; 

111 MyProgram program2 = new MyProgram(); 1 

112 program2 . count + +; 1 

113 | 

114 new MyProgram () ,count + + ; 1 

115 System. out . println (MyProgram. count ); 1 

il 6 } I 

!i 7 } ; 




Output for Code listing 3.14 


i4 


Test your knowledge 

Question 3.11: Visit the Oracle JavaDoc of the dass java. lang, integer (http://docs.orade.eom/javase/7/docs/api/java/lang/Integer.html). 
How many static fields does this dass have? 


Answer 

4. 



■ 

int 

MAX_VALUE, 

■ 

int 

MIN_VALUE, 

■ 

int 

size and 

■ 

Claj 

3 S<Integer> TYPE. 


To learn how to overload and override a method, see Overloading Methods and Constructors. 


API/java.lang.String 


string is a dass built into the Java language defined in the java. lang package. It represents character strings. Strings are ubiquitous in Java. Study the string dass and its 
methods carefully. It will serve you well to know how to manipulate them skillfully. String literals in Java programs, such as "abc", are implemented as instances of this dass like 
this: 



Code section 3.81: String example. 

■-1 

■1 String str = "This is string literal", - i 

I_ I 


On the right hand side a String object is created represented by the string literal. Its object reference is assigned to the str variable. 

Immutability 

Strings are immutable ; that is, they cannot be modified once created. Whenever it looks as if a String object was modified actually a new String object was created. For instance, the 
string. trim () method returns the string with leading and trailing whitespace removed. Actually, it creates a new trimmed string and then returns it. Pay attention on what happens 
in Code section 3.82: 
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Code section 3.82: Immutability. 


i-1 

il String badlyCutText = " Java is great. ";i 

[2 System. out . printin (badlyCutText); , 

i3 ' 

[4 badlyCutText. trim () ; ! 

J5 System. out . printin (badlyCutText); J 

I_ 1 



Output for Code section 3.82 


j-1 

1 Java is great. 1 

1 Java is great. 1 

1_! 


The trim () method call does not modify the object so nothing happens. It creates a new trimmed string and then throws it away. 


S . 

il String badlyCutText = " Java is great. 

[2 System. out . println (badlyCutText); 

■3 

[4 badlyCutText = badlyCutText. trim (); 

■5 System.out. printin (badlyCutText); 



Output for Code section 3.83 


j-1 

1 Java is great. 1 

iJava is great. 1 

I_! 


The returned string is assigned to the variable. It does the job as the trim () method has created a new string instance. 

Concatenation 


The Java language provides special support for the string concatenation with operator +: 

Code section 3.84: Examples of concatenation. 



1 


[l System. out . println ( "First part"); 

■2 System. out .printin ( " second part"); 

[3 String str = "First part" + " second part"; 
■4 System. out . println ( str) ; 


L 



Output for Code section 3.84 


iFirst part 

1 second part 

■First part second part 

L_ 


1 


The concatenation is not always processed at the same time. Raw string literals concatenation is done at compile time, hence there is a single string literal in the byte code of the 
dass. Concatenation with at least one object is done at runtime. 

+ operator can concatenate other objects with strings. For instance, integers will be converted to strings before the concatenation: 


Code section 3.85: Concatenation of integers. 


■1 Sy stem . out . print ln ( "Age= " + 25); 



Output for Code section 3.85 


iAge = 2 5 

l_ 


Each Java object has the string tostring () inherited from the object dass. This method provides a way to convert objects into strings. Most classes override the default 
behavior to provide more specific (and more useful) data in the returned string: 


Code section 3.86: Concatenation of objects. 


■1 System. out . println ( "Age = " + new Integer (31));i 

i_i 



Output for Code section 3.86 


iAge = 31 

l- 


Using StringBuilder/StringBuffer to concatenate strings 

Remember that string objects are immutable objects. Once a string is created, it can not be modified, takes up memory until garbage collected. Be careful of writing a method 
like this: 



Code section 3.87: Raw concatenation. 


T 


■1 public String convertToString (Collection<String> words) { 
[2 String str = 

■3 // Loops through every element in words collection 

i4 for (String word : words) { 

[5 str = str + word + " " ; 

.6 } 

[7 return str; 

| 8 } 


On the + Operation a new string object is created at each iteration. Suppose words contains the elements [ "Foo", "Bar", "Bam", "Baz " ]. At runtime, the method creates 
thirteen strings: 


1 . 

ff ?! 




2. 

"Foo' 




3. 

ff ff 




4. 

"Foo 

ff 



5. 

"Foo 

Bar 

f 


6. 

ff ff 




7. 

"Foo 

Bar 

ff 


8. 

"Foo 

Bar 

Bam" 


9. 

ff ff 




10. 

"Foo 

Bar 

Bam 

ff 

11. 

"Foo 

Bar 

Bam 

Baz 

12. 

ff ff 




13. 

"Foo 

Bar 

Bam 

Baz 


Even though only the last one is actually useful. 
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To avoid unnecessary memory use like this, use the stringBuilder dass. It provides similar functionality to strings, but Stores its data in a mutable way. Only one 
stringBuilder object is created. Also because object creation is time consuming, using stringBuilder produces much faster code. 



Code section 3.88: Concatenation with stringBuilder. 

I-1 

[1 public String convertToString (Collection<String> words) {i 

■2 StringBuilder buf = new StringBuilder(); [ 

[3 // Loops through every element in words collection 1 

■4 for (String word : words) { i 

i5 buf. append (word) ; 1 

[6 buf. append (" "); i 

17 > ! 

[8 return buf. toString () ; ■ 

! 9 } ■ 

i_! 


As stringBuilder isn’t thread safe (see the chapter on Concurrency). You can't use it in more than one thread. For multi-thread environment, use stringBuf fer instead, which 
does the same and is thread safe. However, as stringBuf fer is slower, so only use it when it is required. Moreover, only stringBuf fer existed before Java 5. 

Comparing Strings 

Comparing strings is not as easy as it may first seem. Be aware of what you are doing when comparing string's using ==: 


^ Code section 3.89: Dangerous comparison. 


[l String greeting = "Hello World!"; 

■2 if (greeting == "Hello World!") { 

[3 System. out . printin ( "Match found.") ; 

|4 } 


□I 


Output for Code section 3.89 


iMatch found. 


The difference between the above and below code is that the above code checks to see if the string's are the same objects in memory which they are. This is as a result of the fact 
that string's are stored in a place in memory called the String Constant Pool. If the new keyword is not explicitly used when creating the string it checks to see if it already exists 
in the Pool and uses the existing one. If it does not exist, a new Object is created. This is what allows Strings to be immutable in Java. To test for equality, use the equais (Object) 
method inherited by every dass and defined by string to return true if and only if the object passed in is a string containing the exact same data: 



Code section 3.90: Right comparison. 

-, 


[l String greeting = "Hello World!"; 
i2 if (greeting. equais ( "Hello World!")) { 
[3 System. out . printin ( "Match found.") 

■4 } 


L 


Remember that the comparison is case sensitive. 


Code section 3.91: Comparison with lowercase. 

I- 1 

’l String greeting = "Hello World!"; i 

i2 if (greeting. equais ( "hello world!")) { , 

,3 System. out . printin ( "Match found."); 1 

! 4 } ■ 

i_I 



□ 


Output for Code section 3.90 


iMatch found. 


□ 


Output for Code section 3.91 


To Order string objects, use the compareTo () method, which can be accessed wherever we use a String datatype. The compareTo () method returns a negative, zero, or positive 
number if the parameter is less than, equal to, or greater than the object on which it is called. Let’s take a look at an example: 

Code section 3.92: Order. 

i-1 

■ 1 String personl = "Peter"; i 

[2 String person2 = "John"; j 

■3 if (per son 1 . compareTo (per son2 ) > 0) 1 

i4 // Badly ordered \ 

[5 String temp = personl; 1 

■ 6 personl = person2; i 

[7 person2 = temp; * 

■8 } 1 



The code section 3.92 is comparing the String variable personl to person2. If personl was to be different, even in the slightest manner we will get a value above or below 0 
depending on the exact difference. The result is negative if this String object lexicographically precedes the argument string. The result is a positive integer if this String object 
lexicographically follows the argument string. Take a look at the Java API (http://docs.oracle.eom/javase/7/docs/api/java/lang/String.html#compareTo%28java.lang.String%29) for 
more details. 


Splitting a String 


Sometimes it is useful to split a string into separate strings, based on a regulär expressions. The st 


ring dass has a split () method, since Java 1.4, that will return a String array: 



Code section 3.93: Order. 

j-T 

[l String person = "Brown, JohnrlOO Yonge Street, Toronto: ( 416)777-9999 " ; i 

■2 . . . I 

i3 String[] personData = person . split (":") ; 1 

[4 . . . ! 

■5 String name = personData [0] ; 1 

,6 String address = personData[1]; i 

■7 String phone = personData [2] ; 

L_I 


Another useful application could be to split the String text based on the new line character, so you could process the text line by line. 

Substrings 
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It may also be sometimes useful to create substrings, or strings using the order of letters from an existing string. This can be done in two methods. 
The first method involves creating a substring out of the characters of a string from a given index to the end: 


m 


Code section 3.94: Truncating string. 


il String str = "coffee"; 

,2 System. out .printin(str. substring (3) 


□ 


Output for Code section 3.94 


if ee 


The index of the first character in a string is 0. 

coffee 

012345 

By counting from there, it is apparent that the character in index 3 is the second "f" in "coffee". This is known as the beginindex. All characters from the beginindex until the end 
of the string will be copied into the new substring. 

The second method involves a user-defined beginindex and endindex: 



Code section 3.95: Extraction of string. 

i-1 


1 String str = "supporting"; 

2 System. out . println (str. substring (3, 7) 


L 


_i 


The stringreturned bysubstringo would be "port". 



Output for Code section 3.95 


iport 

I__ 


supporting 

0123456789 


Please note that the endindex is not inclusive. This means that the last character will be of the index endindex- 1 . Therefore, in this example, every character from index 3 to index 
6, inclusive, was copied into the substring. 

V It is easy to mistake the method substring () for substring () (which does not exist and would return with a syntax error on Compilation). Substring is considered to be 
one word. This is why the method name does not seem to follow the common syntax of Java. Just remember that this style only applies to methods or other elements that 
are made up of more than one word. 


String cases 

The string dass also allows for the modification of cases. The two methods that make this possible are toLowerCase () and touppercase (). 



Code section 3.96: Case modification. 
-1 


1 String str = "wlklbOoKs"; 

2 System. out .printin(str. toLowerCase () 

3 System. out .printin(str. toüpperCase () 


I 



iwik ibooks 
■WIKIBOOKS 

L_ 


1 


These methods are useful to do a search which is not case sensitive: 



Code section 3.97: Text search. 

■-1 


1 String word = "Integer"; 

2 String text = "A number without a decimal part is an integer. 

3 + " Integers are a list of digits."; 

4 

5 ... 

6 

7 // Remove the case 

8 String lowerCaseWord = word. toLowerCase (); 

9 String lowerCaseText = text. toLowerCase (); 

10 

11 // Search 

12 int index = lowerCaseText. indexOf (lowerCaseWord); 

13 while (index != -1) { 

14 System. out . printin (word 

15 + " appears at column " 

16 + (index + 1) 

17 

18 index = lowerCaseText. indexOf (lowerCaseWord, index + 1); 

19 } 


L 



Output for Code section 3.97 


ilnteger appears at column 38 . 
«Integer appears at column 47 . 

L_ 


l 


Test your knowledge 


Question 3.12: You have mail addresses in the following form: <firstName> . <lastName>@ <companyName>. org 

Write the string getDisplayName (string) method that receives the mail string as parameter and returns the readable person name like this: lastname Firstname 
Answer 

9 Answer 3.12: getDisplayName () 


1 public static String getDisplayName (String mail) { 

2 String displayName = null; 

3 

4 if (mail != null) { 

5 String[] mailParts = mail. split ("@" ); 

6 String namePart = mailParts[0]; 

7 String[] namesParts = namePart. split ("\\.") ; 
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1 8 i 

i . 

i 9 // The last name , 

.10 String lastName = namesParts[1]; 1 

1 I 

■11 lastName = lastName. toUpperCase (); i 

\l2 ' 

'13 // The first name i 

il4 String firstName = namesParts[0]; ! 

[15 i 

>16 String firstNamelnitial = firstName. substring (0, 1); , 

,17 firstNamelnitial = firstNamelnitial. toUpperCase (); 1 

■18 ! 

■ . 

il9 String firstNameEnd = firstName. substring (1); 

[20 firstNameEnd = firstNameEnd. toLowerCase (); i 

■ 21 ! 

.22 // Concatenation 1 

i 

■23 StringBuilder displayNameBuilder = new StringBuilder(lastName) . append ( " ") . append (firstNamelnitial) . append (firstNameEnd); i 

i24 displayName = displayNameBuilder. toString (); 1 

[25 } ! 

■2 6 | 

,27 return displayName; 1 

■28 } I 

1 i 

L_ 

1. We only process non null strings, 

2. We first split the mail into two parts to separate the personal information from the Company information and we keep the name data, 

3. Then we split the name information to separate the first name from the last name. As the split () method use regulär expression and . is a wildcard character, we have 
to escape it (\ .). However, in a string, the \ is also a special character, so we need to escape it too (\\ .), 

4. The last name is just capitalized, 

5. As the case of all the first name characters will not be the same, we have to cut the first name. Only the first name initial will be capitalized, 

6. Now we can concatenate all the fragments. We prefer to use a StringBuilder to do that. 


See also 


■ oraoj Java API: java.lang.String (http://docs.oracle.eom/javase/7/docs/api/java/lang/String.html) 

■ or Java API: java.lang.StringBuffer (http://docs.oracle.eom/javase/7/docs/api/java/lang/StringBuffer.html) 

■ oraoj Java API: java.lang.StringBuilder (http://docs.oracle.eom/javase/7/does/api/java/lang/StringBuilder.html) 


Classes, Objects and Types 

An object is composed of fields and methods. The fields, also called data members, characteristics, attributes, or properties, describe the state of the object. The methods 
generally describe the actions associated with a particular object. Think of an object as a noun, its fields as adjectives describing that noun, and its methods as the verbs that can be 
performed by or on that noun. 

For example, a Sports car is an object. Some of its fields might be its height, weight, acceleration, and speed. An object's fields just hold data about that object. Some of the methods 
of the sports car could be "drive", "park", "race", etc. The methods really don't mean much unless associated with the sports car, and the same goes for the fields. 

The blueprint that lets us build our sports car object is called a dass. A dass doesn’t teil us how fast our sports car goes, or what color it is, but it does teil us that our sports car will 
have a field representing speed and color, and that they will be say, a number and a word (or hex color code), respectively. The dass also lays out the methods for us, telling the car 
how to park and drive, but these methods can't take any action with just the blueprint — they need an object to have an effect. 

In Java, a dass is located in a file similar to its own name. If you want to have a dass called Sportscar, its source file needs to be Sportscar. java. The dass is created by placing 
the following in the source file: 

Code listing 3.13: SportsCar.java 


11 public dass SportsCar { 

12 /* Insert your code here */ 
■3 } 

l_ 


The dass doesn’t do anything yet, as you will need to add methods and field variables first. 

The objects are different from the primitive types because: 

1. The primitive types are not instantiated. 

2. In the memory, only their value is stored, directly. No reference to an instance is stored. 

3. In the memory, the allocated space is fixed, whatever their value. The allocated space of an object vary, for instance either the object is intantiated or not. 

4. The primitive types don't have methods callable on them. 

5. A primitive type can’t be inherited. 

Instantiation and constructors 

In order to get from dass to object, we "build" our object by instantiation. Instantiation simply means to create an instance of a dass. Instance and object are very similar terms and 
are sometimes interchangeable, but remember that an instance refers to a specific object , which was created from a dass. 

This instantiation is brought about by one of the class's methods, called a constructor. As its name implies, a constructor builds the object based on the blueprint. Behind the scenes, 
this means that Computer memory is being allocated for the instance, and values are being assigned to the data members. 

In general there are four constructor types: default, non-default, copy, and cloning. 

A default constructor will build the most basic instance. Generally, this means assigning all the fields values like null, zero, or an empty string. Nothing would stop you, however, 
from your default sports car color from being red, but this is generally bad programming style. Another programmer would be confused if your basic car came out red instead of say, 
colorless. 

Code section 3.79: A default constructor. 
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■1 SportsCar car = new SportsCar (); 


A non-default constructor is designed to create an object instance with prescribed values for most, if not all, of the object's fields. The car is red, goes from 0-60 in 12 seconds, 
tops out at 190mph, etc. 

Code section 3.80: A non-default constructor. 


■i 
L . 


SportsCar car = new SportsCar ("red", 12, 190) 



A copy constructor is not included in the Java language, however one can easily create a constructor that do the same as a copy constructor. It's important to understand what it is. 
As the name implies, a copy constructor creates a new instance to be a duplicate of an already existing one. In Java, this can be also accomplished by creating the instance with the 
default constructor, and then using the assignment operator to equivocate them. This is not possible in all languages though, so just keep the terminology under your beit. 

Java has the concepts of cloning object, and the end results are similar to copy constructor. Cloning an object is faster than creation with the new keyword, because all the object 
memory is copied at once to destination cloned object. This is possible by implementing the cioneabie interface, which allows the method object. clone () to perform a field- 
by-field copy. 



Code section 3.81: Cloning object. 
■-1 


|1 SportsCar car = oldCar . clone () ; i 

l_i 


Type 

When an object is created, a reference to the object is also created. The object can not be accessed directly in Java, only through this object reference. This object reference has a 
type assigned to it. We need this type when passing the object reference to a method as a parameter. Java does strong type checking. 

Type is basically a list of features/operations, that can be performed through that object reference. The object reference type is basically a contract that guarantees that those 
operations will be there at run time. 

When a car is created, it comes with a list of features/operations listed in the user manual that guarantees that those will be there when the car is used. 

When you create an object from a dass by default its type is the same as its dass. It means that all the features/operations the dass defined are there and available, and can be used. 
See below: 

Code section 3.82: Default type. 

■-1 

■1 (new ClassName ()). operations (); i 

l_i 



You can assign this to a variable having the same type as the dass: 



Code section 3.83: A variable having the same type as the dass. 

;-1 

[l ClassName objRefVariable = new ClassName(); i 

|2 ob jRefVariable . operations () ; , 

i_! 


You can assign the created object reference to the dass, super dass, or to an interface the dass implements: 

Code section 3.84: Using the super dass. 

i-1 



■1 SuperClass objectRef = new ClassName(); // features/operations list are defined by the SuperClass classi 

J 2 . . . I 

■3 Interface inter = new ClassName(); // features/operations list are defined by the interface 1 

l_i 


In the car analogy, the created car may have different Type of drivers. We create separate user manuals for them, Average user manual, Power user manual, Child user manual, or 
Handicapped user manual. Each type of user manual describes only those features/operations appropriate for the type of driver. The Power driver may have additional gears to 
switch to higher speeds, that are not available to other type of users... 

When the car key is passed from an adult to a child we replacing the user manuals, that is called Type Casting. 

In Java, casts can occur in three ways: 

■ up casting going up in the inheritance tree, until we reach the object 

■ up casting to an interface the dass implements 

■ down casting until we reach the dass the object was created from 


Autoboxing/unboxing 

Autoboxing and unboxing, language features since Java 1.5, make the programmer's life much easier when it comes to working with the primitive wrapper types. Consider this code 
fragment: 

^ Code section 3.85: Traditional object creation. 

;-1 

,1 int age = 23; i 

|2 Integer ageObject = new Integer(age); , 


Primitive wrapper objects were Java’s way of allowing one to treat primitive data types as though they were objects. Consequently, one was expected to wrap one’s primitive data 
type with the corresponding primitive wrapper object, as shown above. 

Since Java 1.5, one may write as below and the Compiler will automatically create the wrap object. The extra Step of wrapping the primitive is no longer required. It has been 
automatically boxed up on your behalf: 
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^ Code section 3.86: Autoboxing. 

;-1 

[l int age = 23; i 

J2 Integer ageObject = age; , 


V 


Keep in mind that the Compiler still creates the missing wrapper code, so one doesn't really gain anything performance-wise. Consider this feature a programmer 
convenience, not a performance booster. 


Each primitive type has a dass wrapper: 


Primitive type Class wrapper 


byt e 

char 

short 

int 

long 

f loat 

double 

boolean 

void 


java.lang.Byte 
java.lang.Character 
java.lang.Short 
java.lang.Integer 
java.lang.Long 
java.lang.Float 
j ava.lang.Double 
j ava.lang.Boolean 
java.lang.Void 


Unboxing uses the same process in reverse. Study the following code for a moment. The if Statement requires a boolean primitive value, yet it was given a Boolean wrapper object. 
No problem! Java 1.5 will automatically unbox this. 




Code section 3.87: Unboxing. 


■i 


il Boolean canMove = new Boolean (true) ; 

[2 

■3 if (canMove) { 

[4 System. out . println ("This code is legal in Java 1.5"); 
■5 } 


I. 


Test your knowledge 


Question 3.11: Consider the following code: 




Question 3.11: Autoboxing/unboxing. 


■5 Integer a = 10; 

[6 Integer b = a + 2; 

■7 System . out .printin (b); 


How many autoboxings and unboxings are there in this code? 


Answer 


m 


Answer 3.11: Autoboxing/unboxing. 


il Integer a = 10; 

,2 Integer b = a + 2; 

|3 System, out .printin (b) ; 

l_i 


1 autoboxing at line 1 to assign. 

1 unboxing at line 2 to do the addition. 

1 autoboxing at line 2 to assign. 

No autoboxing nor unboxing at line 3 as print ln () supports the integer class as parameter. 


Methods in the Object class 

Methods in the java. lang. object dass are inherited, and thus shared in common by all classes. 

The cione method 

The java. lang.object. cione ( ) method returns a new object that is a copy of the current object. Classes must implement the marker interface java. lang.cioneabie to indicate 
that they can be cloned. 

The equais method 

The java. lang, ob ject. equais (java. lang, ob ject ) method compares the object to another object and returns a boolean result indicating if the two objects are equal. 
Semantically, this method compares the contents of the objects whereas the equality comparison operator "==" compares the object references. The equais method is used by many 
of the data structure classes in the java. utn package. Some of these data structure classes also rely on the object. hashcode method—see the hashcode method for details on 
the contract between equais and hashcode. Implementing equals() isn't always as easy as it seems, see 'Secrets of equals() (http://www.angehkalanger.com/Articles/JavaSolutions 
/SecretsOfEquals/Equals.html)' for more information. 

The finaüze method 


The java. lang. object. finaüze () method is called exactly once before the garbage collector frees the memory for object. A class overrides finaüze to perform any clean up 
that must be performed before an object is reclaimed. Most objects do not need to override finaüze. 
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There is no guarantee when the f inaiize method will be called, or the Order in which the f inaiize method will be called for multiple objects. If the JVM exits without performing 
garbage collection, the OS may free the objects, in which case the f inaiize method doesn’t get called. 

The f inaiize method should always be declared protected to prevent other classes from calling the f inaiize method. 


■protected void finalize() throws Throwable { ... } 


The getciass method 

The java. lang. Object. getciass () method returns the java. lang. dass object for the dass that was used to instantiate the object. The dass object is the base dass of 
reflection in Java. Additional reflection support is provided in the java. lang. ref lect package. 

The hashcode method 

The java. lang. object. hashcode () method returns an integer (int). This integer can be used to distinguish objects although not completely. It quickly separates most of the 
objects and those with the same hash code are separated later in another way. It is used by the classes that provide associative arrays, for instance, those that implement the 
java .utii. Map interface . They use the hash code to störe the object in the associative array. A good hashcode implementation will return a hash code: 

■ Stahle: does not change 

■ Evenly distributed: the hash codes of unequal objects tend to be unequal and the hash codes are evenly distributed across integer values. 

The second point means that two different objects can have the same hash code so two objects with the same hash code are not necessarily the same ! 

Since associative arrays depend on both the equais and hashcode methods, there is an important contract between these two methods that must be maintained if the objects are to 
be inserted into a Map: 

For two objects a and b 

■ a.equais(b) == b.equais(a) 

■ if a . equais (b) then a . hashCode () == b. hashCode () 

■ but iT a.hashCode () — == b .hashCode () then a.equais (b) 

In Order to maintain this contract, a dass that overrides the equais method must also override the hashcode method, and vice versa, so that hashcode is based on the same 
properties (or a subset of the properties) as equais. 

A further contract that the map has with the object is that the results of the hashcode and equais methods will not change once the object has been inserted into the map. For this 
reason, it is generally a good practice to base the hash function on immutable properties of the object. 

The tostring method 


The java. lang, ob ject .tostring () method returns a java. lang, string that contains a text representation of the object. The tostring method is implicitly called by the 
Compiler when an object Operand is used with the string concatenation operators (+ and +=). 

The wait and notify thread signaling methods 

Every object has two wait lists for threads associated with it. One wait list is used by the synchronized keyword to acquire the mutex lock associated with the object. If the mutex 
lock is currently held by another thread, the current thread is added to the list of blocked threads waiting on the mutex lock. The other wait list is used for signaling between threads 
accomplished through the wait and notify and notifyAli methods. 

Use of wait/notify allows efficient coordination of tasks between threads. When one thread needs to wait for another thread to complete an Operation, or needs to wait until an event 
occurs, the thread can suspend its execution and wait to be notified when the event occurs. This is in contrast to polling, where the thread repeatedly sleeps for a short period of 
time and then checks a flag or other condition indicator. Polling is both more computationally expensive, as the thread has to continue checking, and less responsive since the thread 
won't notice the condition has changed until the next time to check. 

The wait methods 


There are three overloaded versions of the wait method to support different ways to specify the timeout value: java. lang .ob ject .wait (), java. lang, ob ject .wait (long) and 
java. lang. object. wait (long, int ). The first method uses a timeout value of zero (0), which means that the wait does not timeout; the second method takes the number of 
milliseconds as a timeout; the third method takes the number of nanoseconds as a timeout, calculated asioooooo * timeout + nanos. 


The thread calling wait is blocked (removed from the set of executable threads) and added to the object's wait list. The thread remains in the object's wait list until one of three 
events occurs: 


1. another thread calls the object's notify or notifyAli method; 

2. another thread calls the thread's java. lang.Thread. interrupt method; or 

3. a non-zero timeout that was specified in the call to wait expires. 

The wait method must be called inside of a block or method synchronized on the object. This insures that there are no race conditions between wait and notify. When the thread 
is placed in the wait list, the thread releases the object's mutex lock. After the thread is removed from the wait list and added to the set of executable threads, it must acquire the 
object's mutex lock before continuing execution. 


The notify and notifyAli methods 


The java. lang. object. notify () and java. lang. object. notifyAli () methods remove one or more threads from an object's wait list and add them to the set of executable 
threads. notify removes a single thread from the wait list, while notifyAli removes all threads from the wait list. Which thread is removed by notify is unspecified and 
dependent on the JVM implementation. 

The notify methods must be called inside of a block or method synchronized on the object. This insures that there are no race conditions between wait and notify. 


Keywords 


Keywords are special tokens in the language which have reserved use in the language. Keywords may not be used as identifiers in Java 


you cannot declare a field whose name is 
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a keyword, for instance. 

Examples of keywords are the primitive types, int and boolean; the control flow Statements for and if ; access modifiers such as public, and special words which mark the 
declaration and definition of Java classes, packages, and interfaces: dass, package, interface. 

Below are all the Java language keywords: 



■ extends 

■ protected 

abstract 

■ final 

■ public 

assert (since Java 1.4) 

■ finally 

■ return 

boolean 

■ float 

■ short 

break 

■ for 

■ static 

byte 

■ goto (not used) 

■ st riet fp (since Java 1.2) 

case 

■ if 

■ super 

catch 

■ implements 

■ switch 

char 

■ Import 

■ synchronized 

dass 

■ instanceof 

■ this 

const (not used) 

■ int 

■ throw 

continue 

■ interface 

■ throws 

default 

■ long 

■ transient 

do 

■ native 

■ try 

double 

■ new 

■ void 

eise 

■ package 

■ volatile 

enum (since Java 5.0) 

■ private 

■ while 


In addition, the identifiers null, true, and faise denote literal values and may not be used to create identifiers. 

abstract 


abstract is a Java keyword. It can be applied to a dass and methods. An abstract dass cannot be directly instantiated. It must be placed before the variable type or the method 
return type. It is recommended to place it after the access modifier and after the static keyword. A non-abstract dass is a concrete dass. An abstract dass cannot be final. 

Only an abstract dass can have abstract methods. An abstract method is only declared, not implemented: 



Code listing 1: AbstractClass.java 


;- 1 

11 public abstract dass AbstractClass { 1 

12 // This method does not have a body; it is abstract. 1 

13 public abstract void abstractMethod (); 1 

U ' 

15 // This method does have a body; it is implemented in the abstract dass and gives a default behavior .' 

16 public void concreteMethod () { 1 

17 System. out . println ( "Already coded." ); 1 

■8 } ; 

■9 } ; 

i_ 1 


An abstract method cannot be final, static nor native. Either you instantiate a concrete sub-class, either you instantiate the abstract dass by implementing its abstract methods 
alongside a new Statement: 



Code section 1: Abstract dass use. 


i-1 

il AbstractClass mylnstance = new AbstractClass () {■ 

[2 public void abstractMethod () { ’ 

■3 System. out . printin ("Implementation .") ; 1 

! 4 } ! 

;s } ; ; 

I_! 


A private method cannot be abstract. 


assert 


assert is a Java keyword used to define an assert Statement. An assert Statement is used to declare an expected boolean condition in a program. If the program is running with 
assertions enabled, then the condition is checked at runtime. If the condition is faise, the Java runtime System throws a Assert ionError. 

Assertions may be declared using the following syntax: 


■assert expressionl [: expression2]; 1 


expressioni is a boolean that will throw the assertion if it is faise. When it is thrown, the assertion error exception is created with the parameter expression2 (if applicable). 
An example: 



| -, 

iassert list != null && list.size() > 0 : "list variable is null or empty"; 1 
«Object value = list.get(O); 1 

I-! 


Assertions are usually used as a debugging aid. They should not be used instead of validating arguments to pubhc methods, or in place of a more precise runtime error exception. 
Assertions are enabled with the Java -ea or -enabieassertions runtime Option. See your Java environment documentation for additional options for Controlling assertions. 
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boolean 


boolean is a keyword which designates the boolean primitive type. There are only two possible boolean values: true and faise. The default value for boolean fields is faise. 
The following is a declaration of a private boolean field named initiaiized, and its use in a method named synchronizeConnect ion. 



Code section 1: Connection synchronization. 

i-1 


■1 private boolean initiaiized = faise; 

[2 


■3 

h 

[5 

16 

\l 

■8 


public void synchronizeConnection () 
if (!initiaiized) { 

Connection = connect(); 
initiaiized = true; 

} 

} 


{ 


The previous code only creates a connection once (at the first method call). Note that there is no automatic conversion between integer types (such as int) to boolean as is possible 
in some languages like C. Instead, one must use an equivalent expression such as ( i ! = 0 ) which evaluates to true if i is not zero. 

break 

break is a Java keyword. 

Jumps (breaks) out from a loop. Also used at switch Statement. 

For example: 



-, 

for ( int i=0; i < maxLoopIter; i++ ) { 1 

System.out .printin ( "Iter=" +i); 1 

if ( i == 5 ) { ; 

break; // — 5 Iteration is enough — 1 

} ; 

} 1 


See also: 

■ Java Programming/Keywords/switch 

byte 

byte is a keyword which designates the 8 bit signed integer primitive type. 

The java. lang. Byte dass is the nominal wrapper dass when you need to störe a byte value but an object reference is required. 
Syntax: 

x------------------ ---------- ------- ----- - - 

■byte <variable-name> = <integer-value>; 

I_ 

For example: 

J-1 

ibyte b = 65; J 

I-! 

or 

j-1 

ibyte b = ’A'J 

I-! 

The number 65 is the code for ’A’ in ASCII. 

See also: 

■ Java Programming/Primitive Types 

case 

case is a Java keyword. 

This is part of the switch Statement, to find if the value passed to the switch Statement matches a value followed by case. 

For example: 

i-1 

i 1 

iint i = 3; 1 

i i 

iswitch(i) { i 

■ i 

■case 1 : 1 

i 1 

i System. out . printin ("The number is 1."); 1 

i 1 

i break; 1 

■ i 

■case 2 : 1 

i 1 

i System. out . println ("The number is 2."); 1 

i 1 

i break; 1 
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■case 3 : 

i System. out . println ("The number is 3."); // this line will print 

i break; 

■case 4 : 

i System. out . println ("The number is 4."); 

i break; 

■case 5 : 

i System. out . println ("The number is 5."); 

i break; 
idef ault : 

i System. out . println ("The number is not 1, 2, 3, 4, or 5."); 

!} 

L_ 


catch 

catch is a keyword. 

It's part of a try block. If an exception is thrown inside a try block, the exception will be compared to any of the catch part of the block. If the exception match with one of the 
exception in the catch part, the exception will be handled there. 

For example: 


try { 

//. . . 

throw new MyException_l(); 

//. . . 

} catch ( MyException_l e ) { 

// - Handle the Exception_l here — 

} catch ( MyException_2 e ) { 

// - Handle the Exception_2 here — 

} 


See also: 

■ Java Programming/Keywords/try 

char 


char is a keyword. It defines a character primitive type, char can be created from character literals and numeric representation. Character literals consist of a single quote character 
(') (ASCII 39, hex 0x27), a single character, and a close quote ('), such as ' w'. Instead of a character, you can also use Unicode escape sequences, but there must be exactly one. 

Syntax: 



Code section 1: Three examples. 


■1 char oneCharl = ’A'; 

i2 char oneChar2 = 65; 

[3 char oneChar3 = ' \u0041'; 

i4 System. out .printin (oneCharl); 
,5 System. out .printin (oneChar2); 
■6 System. out .printin (oneChar3); 
L__ 


char variable narrtei = 'character 7 '; 



Output for Code section 1 


1a 

iA 
iA 
I _ 


65 is the numeric representation of character ’A', or its ASCII code. 

The nominal wrapper dass is the java. lang. character dass when you need to störe a char value but an object reference is required. 

Code section 2: char wrapping. 


[l char aCharPrimitiveType = 1 A'; 

■2 Character aCharacterObject = aCharPrimitiveType; 


See also: 

■ Java Programming/Primitive Types 

dass 

dass is a Java keyword which begins the declaration and definition of a dass. 
The general syntax of a dass declaration, using Extended Backus-Naur Form, is 


Jclass-declaration ::= [access-modifiers] dass identifier 
■ [ extends-clause ] [implements-clause] 

1 class-body 

lextends-clause ::= extends class-name 
[implements-clause ::= Implements Interface-names 
linterface-names ::= interface-name [, Interface-names] 
,class-body ::= { [ member-declarations ] } 

■member-declarations = member-declaration [ member-declarations] 
imember-declaration = field-declaratIon 
I I initializer 

1 I constructor 

, I method-declaratIon 

1 I class-declaration 


The extends word is optional. If omitted, the dass extends the ob ject dass, as all Java classes inherit from it. 



I 
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See also: 

■ Java Programming/Keywords/new 

const 

const is a reserved keyword, presently not being used. 

In other programming languages, such as C, const is often used to declare a constant. However, in Java, final is used instead. 

continue 

continue is a Java keyword. It skips the remainder of the loop and continues with the next iteration. 

For example: 

;-1 

■ ■ 

iint maxLoopIter = 7; 1 

i 1 

i 1 

i 1 

ifor (int i = 0; i < maxLoopIter; i++ ) { 1 

! if (i == 5) { ' 

i 1 

i continue; // -- 5 iteration is skipped 

i 1 

■ } 1 

■ 1 

i System. printin ("Iteration = " + i); 1 

i 1 

'} ! 


results in 


|o 

■i 

i2 

! 3 

■4 

[6 

■7 

I__ 

See also 

■ Java Programming/Statements 

default 

defauit is a Java keyword. 

This is an optional part of the switch Statement, which only executes if none of the above cases are matched. 

See also: 

■ Java Programming/Keywords/switch 

do 

do is a Java keyword. 

It Starts a do-while looping block. The do-while loop is functionally similar to the while loop, except the condition is evaluated öfter the Statements execute 
Syntax: 

i-1 

■ ■ 

ido { 1 

■ ■ 

i //Statements; 1 

■ ■ 

i} while (condition); 1 


For example: 


do { 

i + + ; 

} while ( i < maxLoopIter ); 


See also: 

■ Java Programming/Statements 

■ Java Programming/Keywords/for 

■ Java Programming/Keywords/while 

double 

double is a keyword which designates the 64 bit float primitive type. 

The java. lang. Double dass is the nominal wrapper dass when you need to störe a double value but an object reference is required. 
Syntax: 
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■double <variable-name> = <float-value> 

I- 


For example: 


■double d = 65.55;' 


See also: 

■ Java Programming/Primitive Types 


eise 


eise is a Java keyword. It is an optional part of a branching Statement. It Starts the 'false' Statement block. 


The general syntax of a if, using Extended Backus-Naur Form, is 


i- 

■branching-Statement 


■condition-clause 
,s ingle-Statement 
■block-Statement 

l_ 


if condition-clause 

single-Statement | 

eise 

single-Statement | 


block-Statement 
block-Statement 


] 


( Boolean Expression ) 
Statement 

{ Statement [ Statement ] } 


For example: 


i 


-i 


-, 

if ( expression ) { 1 

System.out.printin( "'True' Statement block"); 1 

} eise { 1 

System. out . printin (" 1 False' Statement block "); 1 

} 1 


See also: 

■ Java Programming/Keywords/if 

enum 



i-1 

i/** Grades of courses */ 1 

■ enum Grade { A, B, C, D, F }; 1 

! /V ... ; 

■ private Grade gradeA = Grade.A; 1 

i_! 


This enumeration constant then can be passed in to methods: 



- 1 

Student. assignGrade (gradeA); 1 

/ k k I 

* Assigns the grade for this course to the Student' 

* @param GRADE Grade to be assigned ' 

*/ j 

public void assignGrade (final Grade GRADE) { 1 

grade = GRADE; 1 

} ' 


An enumeration may also have parameters: 



Jpublic enum DayOfWeek { 

1 /** Enumeration constants */ 

1 MONDAY(1), TUESDAY(2), WEDNESDAY(3), THURSDAY(4), FRIDAY(5), SATURDAY(6), SUNDAY(O); 


/** Code for the days of the week */ 
private byte dayCode = 0; 

/ k k 

* Private constructor 

* @param VALUE Value that Stands for a day of the week. 

V 

private DayOfWeek ( final byte VALUE) { 
dayCode = java. lang .Math . abs (VALUE%7) ; 

} 

/ k k 

* Gets the day Code 

* ßreturn The day code 
*/ 

public byte getDayCode() { 
return dayCode; 
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■ } 
!} 

i _ _ 


It is also possible to let an enumeration implement interfaces other than java. lang. comparabie and java. io. seriaiizabie, which are already implicitly implemented by each 
enumeration: 


(V 


;- 1 

ipublic enum DayOfWeek implements Runnable { 1 

i MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY; 1 


/ k k 

* Run method prints all elements 
*/ 

public void run () { 

System. out .printin ( "name() = " + name() + 

", toStringO = V" + toStringO + 

} 


extends 

extends is a Java keyword. 

Used in dass and Interface definition to declare the dass or interface that is to be extended. 
Syntax: 


;- 1 

ipublic dass MyClass extends SuperClass 1 

!{ ; 

i //. i 

! } ; 

ipublic interface Mylnterface extends Superinterface 1 

! { ; 

! } ; 

i_ 1 


In Java 1.5 and later, the "extends" keyword is also used to specify an upper bound on a type parameter in Generics. 


\ - 1 

iclass Foo<T extends Number> { /*...*/ }■ 
I_! 


See also: 

■ Java Programming/Creating Objects 

■ Java Programming/Keywords/class 

final 


f inai is a keyword. Beware! It has distinct meanings depending whether it is used for a dass, a method, or for a variable. It must be placed before the variable type or the method 
return type. It is recommended to place it after the access modifier and after the static keyword. 



Code section 1: Keyword order. 

1 - 1 

■1 private static final long serialVersionUID = -5437975414336623381L; i 

I_. 


For a variable 


The final keyword only allows a single assignment for the variable. That is to say, once the variable has been assigned, its value is in read-only. If the variable is a primitive type, 
its value will no longer change. If it is an object, only its reference will no longer change. Keep in mind that its value can still be changed. 



Code section 2: Forbidden double assignment. 

I-1 


1 final int a = 1; 

2 a = 2 ; 


I 


J 



Code section 3: Only modify the value of the object. 

I- 1 

[l final ArrayList list = new ArrayList(); i 

■2 System, out .printin (list . size ()) ; , 

[3 list. add ( "One item"); ■ 

■4 System, out .printin (list . size ()) ; | 

1 _! 



Console for Code section 3 


10 

11 
I. 


A final variable is often used for universal constants, such as pi: 



Code section 4: Pi constant. 
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■1 static final double PI 

I_ 


i 


3.1415926;i 


The final keyword can also be used for method parameters: 



Code section 5: Final method parameter. 

-, 


|i 

i2 

|3 

■4 


public int method (final int inputInteger) 
int outputinteger = inputinteger + 1; 
return outputinteger; 

} 


I 


It is useful for methods that use side effects to update some objects. Such methods modify the content of an object passed in parameter. The method caller will recieve the object 
update. This will fail if the object parameter has been reassigned in the method. Another object will be updated instead. Final method parameter can also be used to keep the code 
clean. 

The final keyword is similar to const in other languages and the readoniy keyword in C#. A final variable cannot be voiatiie. 

For a dass 

The final keyword forbids the creation of a subclass. It is the case of the integer or string dass. 

Code listing 1: SealedClass.java 


11 public final dass SealedClass { 

1 2 public static void main (String[] args) { 

■3 } 

■4 } 

I_ 


A final dass cannot be abstract. The final keyword is similar to sealed keyword in C#. 

For a method 

The final keyword forbids to overwrite the method in a subclass. It is useless if the dass is already final and a private method is implicitly final. A final method cannot be 
abstract. 


Code listing 2: NoOverwriting.java 


11 public dass NoOverwriting { 

12 public final void sealedMethod () { 

■3 } 

! 4 } 


Interest 


The final keyword is mostly used to guarantee a good usage of the code. For instance (non-static) methods, this allows the Compiler to expand the method (similar to an inline 
function) if the method is small enough. Sometimes it is required to use it. For instance, a nested dass can only access the members of the top-level dass if they are final. 

See also Access Modifiers. 


finally 


f inaiiy is a keyword which is an optional part of the try block. 



Code section 1: try block. 

■-1 


1 try { 

2 // . . . 

3 } catch (MyExceptionl e) { 

4 // Handle the Exceptionl here 

5 } catch (MyException2 e) { 

6 // Handle the Exception2 here 

7 } finally { 

8 // This will always be executed no matter what happens 

9 } 


I. 


The code inside the finally block will always be executed. This is also true for cases when there is an exception or even executed return Statement in the try block. 
Three things can happen in a try block. First, no exception is thrown: 



Code section 2: No exception is thrown. 


-j 

1 System. out . println ( "Before the try block"); i 

2 try { [ 

3 System. out . print ln ( "Inside the try block"); 1 

4 } catch (MyExceptionl e) { , 

5 System. out . println (" Handle the Exceptionl"); 1 

6 } catch (MyException2 e) { i 

7 System. out . println ("Handle the Exception2" ); [ 

8 } finally { ■ 

9 System. out .printin ("Execute the finally block, 

10 } | 
11 System. out . println ( "Continue") ; i 



iBefore the try block 
ilnside the try block 
■Execute the finally block 
Continue 

I_ 
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You can see that we have passed in the try block, then we have executed the finaiiy block and we have continued the execution. Now, a caught exception is thrown: 


S Code section 3: Acaugh, exception iS throw. 


1 System. out . printin ( "Before the try block"); 

2 try { 

3 System. out . println ("Enter inside the try block 

4 throw new MyExceptionl () ; 

5 System. out . println ("Terminate the try block") ; 

6 } catch (MyExceptionl e) { 

7 System. out . println ("Handle the Exceptionl"); 

8 } catch (MyException2 e) { 

9 System. out . println ("Handle the Exception2" ); 

10 } finally { 

11 System. out . printin ( "Execute the finally block" 

12 } 

13 System.out .printin ( "Continue" ); 



iBefore the try block 
lEnter inside the try block 
iHandle the Exceptionl 
lExecute the finally block 
iContinue 

I_ 


We have passed in the try block until where the exception occurred, then we have executed the matching catch block, the finally block and we have continued the execution. 
Now, an uncaught exception is thrown: 

m 


We have passed in the try block until where the exception occurred and we have executed the finally block. NO CODE after the try-catch block has been executed. If there is 
an exception that happens before the try-catch block, the finally block is not executed. 

If return Statement is used inside finally, it overrides the return Statement in the try-catch block. For instance, the construct 

Code section 5: Return Statement. 

i-1 

!l try { ! 

[2 return 11; [ 

■3 } finally { ■ 

[4 return 12; ! 

: 5 } : 


will return 12, not 11. Professional code almost never contains Statements that alter execution Order (like return, break, continue) inside the finally block, as such code is more 
difficult to read and maintain. 

float 

float is a keyword which designates the 32 bit float primitive type. 

The java. lang. Float dass is the nominal wrapper dass when you need to störe a float value but an object reference is required. 

Syntax: 


For example: 


■float price = 49.95;' 


Jf loat <variable-name> = <float-value>; 



Console for Code section 4 

-! 

Before the try block 1 

Enter inside the try block 1 

Execute the finally block 1 

l_! 


m 


Code section 4: An uncaught exception is thrown. 


1 System. out . printin ( "Before the try block") ; 

2 try { 

3 System. out . println ("Enter inside the try block 

4 throw new Exception(); 

5 System. out . printin ("Terminate the try block"); 

6 } catch (MyExceptionl e) { 

7 System. out . println ("Handle the Exceptionl"); 

8 } catch (MyException2 e) { 

9 System. out . println ("Handle the Exception2 " ) ; 

10 } finally { 

11 System. out . println ("Execute the finally block" 

12 } 

13 System. out .printin ( "Continue" ); 


See also: 

■ Java Programming/Primitive Types 


for 

for is a Java keyword. 

It Starts a looping block. 

The general syntax of a for, using Extended Backus-Naur Form, is 


for-looping-statement ::= for condition-clause 

single-Statement \ block-Statement 

condition-clause ::= ( before-statement ; Boolean Expression ; after-statement 
single-statement ::= Statement 

block-statement ::= { Statement [ Statement ] } 


For example: 


I 
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ifor ( int i = 0; i < maxLoopIter; i + + ) { 

i 

i System. println ("Iter: " + i); 

i 

1} 

i 

I-! 


See also: 

■ Java Programming/Keywords/while 

■ Java Programming/Keywords/do 

goto 

goto is a reserved keyword, presently not being used. 


if is a Java keyword. It Starts a branching Statement. 


The general syntax of a if , using Extended Backus-Naur Form, is 


i- 

ib r an ching-Statement 


icondition-clause 
,s ingle-st atement 
■block-Statement 

l_ 


if condition-clause 

single-Statement | 

eise 

single-statement \ 


block-Statement 
block-statement 


] 


( Boolean Expression ) 
Statement 

{ Statement [ Statements ] } 


For example: 



i 


if ( boolean Expression ) 

{ 

System. out . println ("'True' Statement block"); 

} 

eise 

{ 

System. out . println ("'False' Statement block") ; 


} 


I 


See also: 

■ Java Programming/Keywords/else 

implements 

Implements is a Java keyword. 


Used in dass definition to declare the Interfaces that are to be implemented by the dass. 
Syntax: 


\ -1 

ipublic dass MyClass implements Mylnterfacel, My Int erf ace2< 

I { ; 

I } 


i 


-i 


See also: 

■ Java Programming/Creating Objects 

■ Java Programming/Keywords/class 

■ Java Programming/Keywords/interface 

import 

Import is a Java keyword. 

It declares a Java dass to use in the code below the import Statement. Once a Java dass is declared, then the dass name can be used in the code without specifying the package the 
dass belongs to. 

Use the character to declare all the classes belonging to the package. 

Syntax: 


j-I 

limport package . JavaClass; ■ 
limport package.*; 1 
I-! 


The static import construct allows unqualified access to static members without inheriting from the type containing the static members: 
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import static java.lang.Math.PI; 


Once the static members have been imported, they may be used without qualification: 


jj double r = cos (PI * theta); 

i-- 

Caveat: use static import very sparingly to avoid polluting the program's namespace! 
See also: 

■ Java Programming/Packages 

instanceof 


instanceof is a keyword. 

It checks if an object reference is an instance of a type, and returns a boolean value; 

The <object-reference> instanceof object will return true for all non-null object references, since all Java objects are inherited from object. instanceof will always return 
faise if <object-reference> is null. 

Syntax: 

■ -I 

■<ob ject-ref erence> instanceof TypeName i 

i_i 

For example: 

■- 1 

■ i 

'dass Fruit 1 

1 i 

; { ; 

; } ; 

[ dass Apple extends Fruit 1 

! { ; 

; / 7 ... ; 

i } ; 

[ dass Orange extends Fruit 1 

| { ; 

;//... ; 

i } ; 

[ public dass Test 1 

! { ; 

[ public static void main (String[] args) 1 

! { ; 

, Collection<Object> coli = new ArrayList<Object>(); 1 

■ i 

■ i 

, Apple appl = new Apple(); 1 

, Apple app2 = new Apple(); ' 

, coli.add(appl); ' 

, coli. add (app2) ; jj 

■ i 

■ i 

i Orange orl = new Orange(); ' 

i Orange or2 = new Orange(); ' 

I coli. add (orl); [ 

! coli. add (or2); [ 

' i 

■ i 

! printColl(coli); [ 

I } ! 

■ i 

■ i 

i private static String printColl ( Collection<?> coli )[ 

I { ! 

i for (Object obj : coli) [ 

! i ! 

i if ( obj instanceof Object ) ' 

! { ! 

i i 

i System. out . print ("It is a Java Object and");, 

I } ! 

i i 

i if ( obj instanceof Fruit ) , 

! i ! 

■ i 

i System. out .print( "It is a Fruit and"); i 

I } ! 

■ i 

i if ( obj instanceof Apple ) , 

I { ! 

■ i 

i System. out . printin ("it is an Apple"); , 

! ) ! 

■ i 

i if ( obj instanceof Orange ) , 

! i ! 

■ i 

i System. out . printin ("it is an Orange"); | 

■ ) ! 

■ } ! 

> } ! 

■ } ! 

■ i 

i_i 

Run the program: 

■ - 1 

Jjava Test i 

l_i 

The output: 

- 1 

["It is a Java Object and It is a Fruit and it is an Apple" i 

i"It is a Java Object and It is a Fruit and it is an Apple" [ 

,"It is a Java Object and It is a Fruit and it is an Orange" i 

■"It is a Java Object and It is a Fruit and it is an Orange" , 

i_! 
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Note that the instanceof operator can also be applied to interfaces. For example, if the example above was enhanced with the interface 


- n 

interface Edible 1 

{ ; 

//... j 

} 1 


and the classes modified such that they implemented this interface 



we could ask if our object were edible. 


iif ( obj instanceof Edible ) 


System. out .printin ( "it is edible"); 


l_ 1 


int 

int is a keyword which designates the 32 bit signed integer primitive type. 

The java. lang. integer dass is the nominal wrapper dass when you need to störe an int value but an object reference is required. 
Syntax: 

i--- 

'int <variable-name> = <integer-value>; 

l- 

For example: 


iint i = 65;' 


See also: 

■ Java Programming/Primitive Types 

interface 

interface is a Java keyword. It Starts the declaration of a Java Interface. 

For example: 

^ -- 1 

■ ■ 

ipublic interface Samplelnterf ace 1 

i 1 

■ { 1 

■ ■ 

i public void methodlO; 1 

i 1 

i //... 1 

■ ■ 

'} 1 

■ ■ 

i_! 

See also: 

■ Java Programming/Keywords/new 

long 

long is a keyword which designates the 64 bit signed integer primitive type. 

The java. lang. Long dass is the nominal wrapper dass when you need to störe a long value but an object reference is required. 
Syntax: 

t--------------- - -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

■long <variable-name> = <integer-value>; 

I-- 

For example: 
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i-1 

ilong timestamp = 1269898201; 1 

l_ 1 


See also: 

■ Java Programming/Primitive Types 

native 

native is a java keyword. It marks a method, that it will be implemented in other languages, not in Java. The method is declared without a body and cannot be abstract. It works 
together with JNI (Java Native Interface). 

Syntax: 

' -, 

1 [public|protected|private] native method(); i 

l-1 

Native methods were used in the past to write performance critical sections but with java getting faster this is now less common. Native methods are currently needed when 

■ You need to call from java a library, written in another language. 

■ You need to access System or hardware resources that are only reachable from the other language (typically C). Actually, many System functions that interact with real 
Computer (disk and network IO, for instance) can only do this because they call native code. 

To complete writing native method, you need to process your dass with javah tool that will generate a header code in C. You then need to provide implementation of the header 
code, produce dynamically loadable library (.so under Linux, . dii under Windows) and load it (in the simplest case with System, load (iibrary_fiie_name) . The code 
completion is trivial if only primitive types like integers are passed but gets more complex if it is needed to exchange strings or objects from the C code. In general, everything can 
be on C level, including creation of the new objects and calling back methods, written in java. 

To call the code in some other language (including C++), you need to write a bridge from C to that language. This is usually trivial as most of languages are callable from C. 

See also 

■ [3] (http://java.sun.com/developer/onhneTraining/Programming/JDCBook/jni.html) - JNI programming tutorial. 

■ [4] (http://java.sun.eom/j2se/l.3/docs/guide/jni/spec/jniTOC.doe.html) - JNI specification. 


new 

new is a Java keyword. It creates a Java object and allocates memory for it on the heap. new is also used for array creation, as arrays are also objects. 
Syntax: 


For example: 


■<JavaType> <variable> = new <JavaObject>(); 


-, 

LinkedList list = new LinkedList(); 1 
int[] intArray = new int [10]; 1 
String[][] stringMatrix = new String[5][10];■ 


See also: 

■ Java Programming/Creating Objects 

package 

package is a Java keyword. It declares a 'name space’ for the Java dass. It must be put at the top of the Java file, it should be the first Java Statement line. 
To ensure that the package name will be unique across vendors, usually the Company url is used starting in backword. 

Syntax: 

Jpackage package; 

l_ 

For example: 


ipackage com.mycompany .myapplication .mymodule; 1 


See also: 

■ Java Programming/Packages 

■ Java Programming/Keywords/import 

private 

private is a Java keyword which declares a member’s access as private. That is, the member is only visible within the dass, not from any other dass (including subclasses). The 
visibility of private members extends to nested classes. 
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Please note: Because access modifiers are not handled at instance level but at dass level, private members of an object are visible from other instances of the same dass! 


Syntax: 


jprivate void method () ; 


See also: 

■ Java Programming/Access Modifiers 

protected 

protected is a Java keyword. 

This keyword is an access modifier, used before a method or other dass member to signify that the method or variable can only be accessed by elements residing in its own dass or 
classes in the same package (as it would be for the default visibility level) but moreover from subclasses of its own dass, including subclasses in foreign packages (if the access is 
made on an expression, whose type is the type of this subclass). 

Syntax: 


jprotected 


<returnType> <methodName>(<parameters>); 


For example: 


iprotected int getAge () 


“l 


iprotected void setYearOfBirth ( int year) ; 

I-- 


See also: 

■ Java Programming/Scope#Access modifiers 

public 

public is a Java keyword which declares a member's access as public. Public members are visible to all other classes. This means that any other dass can access a public field or 
method. Further, other classes can modify public fields unless the field is declared as final. 

A best practice is to give fields private access and reserve public access to only the set of methods and final fields that define the dass' public constants. This helps with 
encapsulation and information hiding, since it allows you to change the implementation of a dass without affecting the consumers who use only the public API of the dass. 

Below is an example of an immutable public dass named Length which maintains private instance fields named units and magnitude but provides a public constructor and 
two public accessor methods. 

Code listing: Length.java 


i 1 package org.wikibooks.java; 1 

! 2 ■ 

i 1 

i 3 public dass Length { 1 

i * 

i 4 private double magnitude; 1 

i 1 

i 5 private String units; 1 

i 1 

i 6 1 

i 1 

i 7 public Length ( double magnitude, String units) { 1 

i 8 if ( (units == null ) | | (units. trim (). length ()== 0)) { 1 

i 9 throw new IllegalArgumentException( "non-null, non-empty units required . " ) ; 1 

110 } 1 

i 1 

111 1 

i 1 

112 this . magnitude = magnitude; 1 

i 1 

■13 this. units = units; 1 

II 4 } 1 

i 1 

il 5 1 

i 1 

116 public double getMagnitude () { 1 

i 1 

117 return magnitude; 1 

!i 8 } ; 

Il 9 1 

i 1 

■20 public String getUnitsO { 1 

i 1 

121 return units; 1 

122 } ; 

123 } ; 

1 

1 _ 1 

return 

return is a Java keyword. 

Returns a primitive value, or an object reference, or nothing(void). It does not return object values, only object references. 


Syntax: 

1 -| 

ireturn variable; // - Returns variable i 

,°r 8 

■return; //-Returns nothing « 

I-1 


short 
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short is a keyword. It defines a 16 bit signed integer primitive type. 
Syntax: 


For example: 


■short <variable-name> = <integer-value>; 


j- 1 

ishort age = 65; J 

I_! 


See also: 

■ Java Programming/Primitive Types 

static 


static is a Java keyword. It can be applied to a field, a method or an inner dass. A static field, method or dass has a single instance for the whole dass that defines it, even if there 
is no instance of this dass in the program. For instance, a Java entry point (main ()) has to be static. A static method cannot be abstract. It must be placed before the variable type 
or the method return type. It is recommended to place it after the access modifier and before the final keyword: 


^ Code section 1: Static field and method. 

il public static final double pi = 3.1415900; 

| 2 

■3 public static void main (String[] args) { 

[4 //. . . 

|5 } 


The static items can be called on an instantiated object or directly on the dass: 



Code section 2: Static item calls. 
- 


,1 double aNumber = MyClass.pi; 
■2 MyClass .main (new String[0]); 

L__ 


Static methods cannot call non static methods. The this current object reference is also not available in static methods. 

Interest 


■ Static variables can be used as data sharing amongst objects of the same dass. For example to implement a counter that Stores the number of objects created at a given time 
can be defined as so: 

Code listing 1: CountedObject.java 


1 public CountedObject { 

2 private static int counter; 

3 

4 public AClass() { 

5 

6 counter += 1; 

7 } 

8 

9 public int getNumberOfObjectsCreated () { 

10 return counter; 

11 } 

12 } 


The counter variable is incremented each time an object is created. 

Public static variable should not be used, as these become global variables that can be accessed from everywhere in the program. Global constants can be used, however. See 
below: 

Code section 3: Constant definition. 


■1 public static final String CONSTANT_VAR = "Const";i 



■ Static methods can be used for utility functions or for functions that do not belong to any particular object. For example: 


Code listing 2: ArithmeticToolbox.java 


i-1 

il public ArithmeticToolbox { 1 

',2 ' 

13 public static int addTwoNumbers ( int firstNumber, int secondNumber) 1 

14 return firstNumber + secondNumber; 1 

■5 } ; 

■6 } ; 

i_! 


See also Static methods 

strictfp 
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strictfp is a java keyword, since Java 1.2 . 

It makes sure that floating point calculations result precisely the same regardless of the underlying operating System and hardware platform, even if more precision could be 
obtained. This is compatible with the earlier Version of Java 1.1 . If you need that use it. 

Syntax for classes: 


[public strictfp dass MyClass 

'{ 

; // ... 

■} 


Syntax for methods: 

ipublic strictfp void method () 
[{ 

|} 


See also: 

■ http://en.wikipedia.org/wiki/Strictfp 


super 


super is a keyword. 

■ It is used inside a sub-class method definition to call a method defined in the super dass. Private methods of the super-class cannot be called. Only public and protected 
methods can be called by the super keyword. 

■ It is also used by dass constructors to invoke constructors of its parent dass. 

Syntax: 

r - - - - - -- --- - -- -- - - - - - - - - - -- 

■super . <method-name> ( ) ; 


For example: 


Code listing 1: SuperClass.java 

;- 1 

11 public dass SuperClass { 1 

12 public void printHello() { 1 

13 System. out . printin ( "Hello from SuperClass"); 1 

14 return; 1 

■5 } [ 

■6 } 


Code listing 2: SubClass.java 

;- 1 

i 1 public dass SubClass extends SuperClass { 1 

i 2 public void printHello() { 1 

i 3 super . printHello (); 1 

i 4 System. out . print ln ( "Hello from SubClass"); 1 

i 5 return; 1 

16 } [ 
i 7 public static main (String[] args) { 1 

i 8 SubClass obj = new SubClass(); 1 

i 9 obj. printHello () ; 1 

!lO } [ 

In } : 


Running the above program: 

Command for Code listing 2 

J-I 

i$Java SubClass 8 

l-! 

Output of Code listing 2 

i-1 

■ ■ 

iHello from SuperClass 1 

i 1 

iHello from SubClass 1 

■ ■ 

l_! 


In Java 1.5 and later, the "super" keyword is also used to specify a lower bound on a wildcard type parameter in Generics. 



Code section 1: A lower bound on a wildcard type parameter. 

i- 1 

il public void sort (Comparator<? super T> comp) { i 

[2 [ 

[3 } ; 

L_I 


See also: 


■ extends 
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switch 

switch is a Java keyword. 

It is a branching Operation, based on a number. The ’number' must be either char, byte, short, or int primitive type. 

Syntax: 

r- — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — 

I 

■switch ( <integer-var> ) 

i{ 

case <labeli>: <statements>; 
case <label 2 >: <statements>; 

case <label n >: <statements>; 
default : <statements>; 

l_i 

When the <integer-var> value match one of the <label>, then: The Statements after the matched label will be executed including the following label’s Statements, until the end of the 
switch block, or until a break keyword is reached. 


For example: 




int var = 3; 

switch ( var ) 

case 1 : 

System. out . printin ( "Case: 1" ); 

System. out . printin ( "Execute until break" ); 

break; 
case 2: 

System. out . printin ( "Case: 2" ); 

System. out . printin ( "Execute until break" ); 

break; 
case 3: 

System. out . printin ( "Case: 3" ); 

System. out . println ( "Execute until break" ); 

break; 
case 4: 

System. out . printin ( "Case: 4" ); 

System. out . println ( "Execute until break" ); 

break; 
default : 

System. out . printin ( "Case: default" ); 

System. out . println ( "Execute until break" ); 

break; 


The output from the above Code is: 


\ -, 

[Case : 3 i 

■Execute until break , 

i_! 


The same Code can be written with if-else blocks": 



int var = 3; 


if ( var == 1 ) { 

System. out . printin ( "Case: 1" ); 

System. out . printin ( "Execute until break" ); 
} eise if ( var == 2 ) { 

System. out . printin ( "Case: 2" ); 

System. out . printin ( "Execute until break" ); 
} eise if ( var == 3 ) { 

System. out . printin ( "Case: 3" ); 

System. out . printin ( "Execute until break" ); 
} eise if ( var == 4 ) { 

System. out . println ( "Case: 4" ); 

System. out . printin ( "Execute until break" ); 
} eise { 

// — This is the default part — 

System. out . printin ( "Case: default" ); 

System. out . printin ( "Execute until break" ); 


L 


See also: 

■ Java Programming/Keywords/if 

synchronized 

synchronized is a keyword. 

It marks a critical section. A critical section is where one and only one thread is executing. So to enter into the marked Code the threads are synchronized, only one can enter, the 
others have to wait. For more information see Synchronizing Threads Methods or [5] (http://java.sun.com/docs/books/tutorial/essentiaFconcurrency/syncmeth.html). 

The synchronized keyword can be used in two ways: 

■ Create a synchronized block 

■ Mark a method synchronized 

A synchronized block is marked as: 
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m 


Code section 1: Synchronized block. 


[1 synchronized (<object_reference>) { 

■2 // Thread. currentThread () has a 


lock on object_reference. All other threads trying to access it will l 


i 3 

■4 } 


// be blocked untll the current thread releases the lock. 


l_ 


The syntax to mark a method synchronized is: 



Code section 2: Synchronized method. 


i 


'1 public synchronized void method () { 

i2 // Thread.currentThread() has a lock on this object, i.e. a synchronized method is the same as 
,3 // calling { synchronized (this) {...} }. 

■4 } 


I 


The synchronization is always associated to an object. If the method is static, the associated object is the dass. If the method is non-static, the associated object is the instance. 
While it is allowed to declare an abstract method as synchronized, it is meaningless to do so since synchronization is an aspect of the implementation, not the declaration, and 
abstract methods do not have an implementation. 

Singleton example 

As an example, we can show a thread-safe Version of a singleton: 


Code listing 1: Singleton.java 


1 /** 

2 * The singleton dass that can be instantiated only once with lazy instantiation 

3 V 

4 public dass Singleton { 

5 /** Static dass instance */ 

private volatile static Singleton instance = null; 


6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 } 




Standard private constructor 


*/ 

private Singleton () { 

// Some Initialisation 

} 

/ * -k 

* Getter of the singleton instance 

* Sreturn The only instance 

* / 

public static Singleton getlnstance () { 

if (instance == null) { 

// If the instance does not exist, go in time-consuming 
// section: 

synchronized (Singleton . dass ) { 

if (instance == null) { 

instance = new Singleton(); 


} 


} 


return instance; 


this 

this is a Java keyword. It contains the current object reference. 

1. Solves ambiguity between instance variables and parameters . 

2. Used to pass current object as a parameter to another method . 

Syntax: 

'this . method() ; 
ior 

,this variable; 

I_ 

Example #1 for case 1: 


i 


;-1 

ipublic dass MyClass 1 

! { ; 

! //. .. « 

i private String value; 1 

!//... j 

i public void setMemberVar ( String value )■ 

' { ! 

i this.value= value; 1 

' } ! 

' } ! 

i_ 1 


Example #2 for case 1: 
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public dass MyClass 

' 

MyClass (int a, int b) { 

System. out . println (" int a: " + a); 
System. out . println ("int b: " + b); 

} 

MyClass( int a) { 

this (a, 0); 

} 

//. . . 

public static void main (String[] args) { 
new MyClass(1, 2); 

new MyClass(5); 

} 


throw 

throw is a keyword. It 'throws' an exception. 
Syntax: 


•throw <Exception Ref>; 

I- 


For example: 



;- 1 

ipublic Customer findCustomer ( String name ) throws 1 ’ 1 CustomerNotFoundException ''' 1 

! { ; 

i Customer custRet = null; 1 

i Iterator iter = _customerList. iterator (); 1 

i while ( iter. hasNext () ) 1 

! { ; 

i Customer cust = (Customer) iter.next(); 1 

i if ( cust. getName () .equals ( name ) ) 1 

! { ; 

i // - Customer find -- 1 

i custRet = cust; 1 

i break; 1 

! } ; 

! } ; 

i if ( custRet == null ) 1 

■ { ! 

i // - Customer not found - 1 

i throw new '' 'CustomerNotFoundException' '' ( "Customer "+ name + "was not found" );' 

■ } ! 

i return custRet ' 


See also: 

■ Java Programming/Keywords/throws 

throws 

throws is a Java keyword. It is used in a method definition to declare the Exceptions to be thrown by the method. 
Syntax: 


public myMethod() throws MyExceptionl, MyException2 

{ 

} 


Example: 


dass MyDefinedException extends Exception 

{ 

public MyDefinedException (String str) 

{ 

super (str); 

} 

} 

public dass MyClass 

{ 

public static void showMyName (String str) throws MyDefinedException 

{ 

if ( str. equals ( "What is your Name?")) 

throw new MyDefinedException( "My name is Bläh Bläh"); 

} 

public static void main (String a[]) 

{ 

try 

{ 

showMyName( "What is your Name?"); 

} 

catch (MyDefinedException mde) 

{ 


93 sur 134 


30/01/2016 20:09 













Java Programming/Print Version - Wikibooks, openbooks for an open worldhttps://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


mde.print StackTrace (); 


transient 

transient is a Java keyword which marks a member variable not to be serialized when it is persisted to streams of bytes. When an object is transferred through the network, the 
object needs to be 'serialized’. Serialization converts the object state to serial bytes. Those bytes are sent over the network and the object is recreated from those bytes. Member 
variables marked by the java transient keyword are not transferred; they are lost intentionally. 

Syntax: 

i-1 

■private transient <member-variable>; i 

!° r [ 

■transient private <member-variable>; 1 

l_i 


For example: 


i-1 

ipublic dass Foo implements Serializable 1 

‘ { ! 

i private String saveMe; 1 

i private transient String dontSaveMe; 1 

i private transient String password; 1 


See also: 

■ Java language specification reference: jls (http://java.sun.eom/docs/books/jls/third_edition/html/elasses.html#8.3.l.3) 

■ Serializable Interface. Serializable (http://en.wikipedia. 0 rg/wiki/Serializati 0 n#Java) 


try 

try is a keyword. 

It Starts a try block. If an Exception is thrown inside a try block, the Exception will be compared any of the catch part of the block. If the Exception match with one of the 
Exception in the catch part, the exception will be handled there. 

Three things can happen in a try block: 

■ No exception is thrown: 

■ the code in the try block 

■ plus the code in the finally block will be executed 

■ plus the code after the try-catch block is executed 

■ An exception is thrown and a match is found among the catch blocks: 

■ the code in the try block until the exception occurred is executed 

■ plus the matched catch block is executed 

■ plus the finally block is executed 

■ plus the code after the try-catch block is executed 

■ An exception is thrown and no match found among the catch blocks: 

■ the code in the try block until the exception occurred is executed 

■ plus the finally block is executed 

■ NO CODE after the try-catch block is executed 

For example: 



public void method () throws NoMatchedException 
{ 

try { 

//. . . 

throw new ’ 1 ' MyException_l ' ' ' ; 

//. . . 

} catch ( MyException_l e ) { 

//- ' ' 'Handle the Exception_l here' ' ' — 

} catch ( MyException_2 e ) { 

// - Handle the Exceptlon_2 here — 

} finally { 

// - This will always be executed no matter what — 

} 

// - Code after the try-catch block 


How the catch-blocks are evaluated see Catching Rule 
See also: 

■ Java Programming/Keywords/catch 

■ Java Programming/Keywords/finally 

■ Java Programming/Throwing and Catching Exceptions#Catching Rule 

void 
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void is a Java keyword. 

Used at method declaration and definition to specify that the method does not return any type, the method returns void. It is not a type and there is no void references/pointers as in 
C/C++. 

For example: 


i- ^ 

ipublic void method () 1 

' { ! 

8 // 1 

i return; // — In this case the return is optional 1 

' } ! 

L_! 


See also: 

■ Java Programming/Keywords/return 

volatile 

voiatile is a keyword. 

When member variables are marked with this keyword, it changes the runtime behavior in a way that is noticeable when multiple threads access these variables. Without the volatile 
keyword, one thread could observe another thread update member variables in an Order that is not consistent with what is specified in sourcecode. Unlike the synchronized 
keyword, concurrent access to a volatile field is allowed. 

Syntax: 

I-I 

«private volatile <member-variable>; i 

!° r | 

•volatile private <member-variable>; 1 

I-1 


For example: 


iprivate volatile changingVar; j 
L_! 


See also: 

■ Java Programming/Keywords/synchronized 


while 

while is a Java keyword. 

It Starts a looping block. 

The general syntax of a while, using Extended Backus-Naur Form, is 


while-looping-statement ::= while condition-clause 

single-Statement | block-Statement 

condition-clause ::= ( Boolean Expression ) 

single-statement ::= Statement 

block-statement ::= { Statement [ Statements ] } 


For example: 


i 


i-1 

iwhile ( i < maxLoopIter ) 1 

' { ! 

i System. println ("Iter=" + i + +);‘ 

I } 1 


See also: 

■ Java Programming/Statements 

■ Java Programming/Keywords/for 

■ Java Programming/Keywords/do 


Packages 

If your application becomes quite big, you may have lots of classes. Although you can browse them in their alphabetic Order, it becomes confusing. So your application classes can 
be sorted into packages. 

A package is a name space that mainly contains classes and interfaces. For instance, the Standard dass ArrayList is in the package java. utii. For this dass, 

java. ut ii. ArrayList is called its fully qualified name because this syntax has no ambiguity. Classes in different packages can have the same name. For example, you have the 

two classes java. ut ii. Date and java. sqi. Date which are not the same. If no package is declared in a dass, its package is the default package. 
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Package declaration 

In a dass, a package is declared at the top of the source code using the keyword package: 


Code listing 3.14: BusinessClass.java 


i-1 

11 package business; 1 

12 > 

13 public dass BusinessClass { 1 

■4 } | 

l_ 1 


If your dass is declared in a package, say business, your dass must be placed in a subfolder called business from the root of your application folder. This is how the Compiler and 
the dass loader find the Java files on the file System. You can declare your dass in a subpackage, say engine. So the full package is business . engine and the dass must be placed 
in a subsubfolder called engine in the subfolder business (not in a folder called business . engine). 


Import and dass usage 

The simpliest way to use a dass declared in a package is to prefix the dass name with its package: 




Code section 3.88: Package declaration. 


■1 business. BusinessClass myBusinessClass = new business. BusinessClass (); i 


If you are using the dass from a dass in the same package, you don’t have to specify the package. If another dass with the same name exists in another package, it will use the local 
dass. 

The syntax above is a bit verbose. You can import the dass by using the Import Java keyword at the top of the file and then only specify its name: 


Code listing 3.15: MyClass.java 


i-1 

11 import business.BusinessClass; 1 

12 i 

13 public dass MyClass { 1 

14 public static void main (String[] args) { 1 

15 BusinessClass myBusinessClass = new BusinessClass(); 1 

■6 } ; 

\i } ; 

i_ 1 


Note that you can't import two classes with the same name in two different packages. 

The classes integer and string belongs to the package java. lang but they don't need to be imported as the java. lang package is implicitly imported in all classes. 


Wildcard imports 


It is possible to import an entire package, using an asterisk: 



Code section 3.89: Wildcard imports. 

|- 1 

■1 import javax . swing . * ; i 

l_i 


While it may seem convenient, it may cause problems if you make a typographical error. For example, if you use the above import to use JFrame, but then type jFraim frame = 
new JFraim ( );, the Java Compiler will report an error similar to "Cannot find symbol: JFraim". Even though it seems as if it was imported, the Compiler is giving the error report at 
the first mention of JFraim, which is half-way through your code, instead of the point where you imported JFrame along with everything eise in javax.swing. 

If you change this to import javax. swing. JFraim; the error will be at the import instead of within your code. 

Furthermore, if you import javax. swing . *; and import java. utii. *; , and javax.swing.Queue is later added in a future Version of Java, your code that uses Queue (java.util) 
will fail to compile. This particular example is fairly unlikely, but if you are working with non-Oracle libraries, it may be more likely to happen. 

Package convention 

A package name should Start with a lower character. This eases to distinguish a package from a dass name. In some operating Systems, the directory names are not case sensitive. So 
package names should be lowercase. 

The Java package needs to be unique across Vendors to avoid name collisions. For that reason Vendors usually use their domain name in reverse Order. That is guaranteed to be 
unique. For example a Company called Your Company Inc., would use a package name something like this: com. yourcompany. yourapplicat ionname. yourmoduie. Yourciass. 

Importing packages from .jar files 

If you are importing library packages or classes that reside in a .jar file, you must ensure that the file is in the current classpath (both at compile- and execution-time). Apart from 
this requirement, importing these packages and classes is the same as if they were in their full, expanded, directory structure. 

For example, to compile and run a dass from a project's top directory (that contains the two directories /source and /libraries) you could use the following command: 

Compilation 


i$ javac -classpath libraries/lib.jar source/MainClass.java 1 

l-! 


And then to run it, similarly: 
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Execution 


J-1 

i$ java -classpath libraries/lib . jar source/MainClass 1 

l_ 1 


The above is simplified, and demands that Mainciass be in the default package, or a package called source, which isn't very desirable. 

Class loading/package 

The runtime identity of a class in Java is defined by the fully qualified class name and its defining class loader. This means that the same class, loaded by two different class loaders, 
is seen by the Virtual Machine as two completely different types. 


Arrays 

An array is similar to a table of objects or primitive types, keyed by index. You may have noticed the stränge parameter of the default main () method (string [ ] args) since the 
beginning of the book. It is an array. Let's handle this parameter: 


Code listing 3.15: The default array parameter. 

i-1 

11 public class ArrayExample { 1 

12 public static void main (String[] args) { 1 

13 for (int i = 0; i < args.length; + + i) { 1 

14 System. out . println ( "Argument #" + (i + 1) + " + args [i] );' 

k } ; 

■6 } ; 

\i } ; 

i_! 



Console for Code listing 3.15 


i-1 

i$ java ArrayExample This is a test 1 
lArgument #1 This 1 
lArgument #2 is 1 
lArgument #3 a 1 
lArgument #4 test 1 
L_ 1 


In the code listing 3.15, the array is args. It is an array of string objects (here those objects are the words that have been typed by the user at the program launching). At line 4, 
One contained object is accessed using its index in the array. You can see that its value is printed on the Standard output. Note that the strings have been put in the array with the 
right Order. 

Fundamentals 

In Java, an array is an object. This object has a given type for the contained primitive types or objects (int, char, string, ...). An array can be declared in several ways: 

Code section 3.52: Array declarations. 

;-1 

[l int[] arrayl = null; i 

■2 int array2 [ ] = null; [ 



Those syntaxes are identical but the first one is recommended. It can also be instantiated in several ways: 



Code section 3.53: Array instantiations. 

;-l 

[l arrayl = new int [10]; i 

|2 arrayl = {1, 2, 3, 4, 5, 6 , 7, 8, 9, 10} 

i_! 


At line 1, we instantiate an array of 10 items with non-initialized items. At line 2, we instantiate an array of 10 given items. It will each be given an index according to its Order. We 
can know the size of the array using the lengt h attribute: 



Code section 3.54: The array size. 

-, 


1 int nbltems = 10; 

2 Object[] array3 = new Object[nbltems]; 

3 System. out .printin (array3. length) ; 



Output for Code section 3.54 



Arrays are allocated at runtime, so the specified size in an array creation expression may be a variable (rather than a constant expression as in C). However, the size of an 
instantiated array never changes. If you need to change the size, you have to create a new instance. Items can be accessed by their index. Beware! The first index is 0: 


^ Code section 3.55: The array indexes. 


1 char [] array4 = {'a', 'b', 'c', 'd', 'e'}; 

2 System. out .printin (array4[2]); 

3 array4 [ 4] = 'z'; 

4 System. out .printin (array4[4]); 



Output for Code section 


3.55 



If you attempt to access to a too high index or negative index, you will get an ArrayindexOutofBoundsException. 


Test your knowledge 


Question 3.20: Consider the following code: 


Question 3.20: Question20.java 
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;-l 

11 public dass Question20 { 1 

12 public static void main (String [ ] args) { 1 

13 String[] listOfWord = {"beggars", "can't", "be", " choosers "} ; 1 

14 System. out . println (listOfWord[1]); 1 

15 System. out . println (1istOfWord[1istOfWord. length- 1]); 1 

■6 } ; 

\i } ; 

i_! 


What will be printed in the Standard output? 
Answer 

Output for Question 3.20 

i-1 

■ ■ 

ican ' t 1 

■ ■ 

ichoosers 1 

■ ■ 

l_! 


Indexes Start at 0. So the index 1 point at the second string (can ' t). There are 4 items so the size of the array is 4. Hence the item pointed by the index 3 is the last one 

(choosers). 


Two-Dimensional Arrays 


Actually, there are no two-dimensional arrays in Java. However, an array can contain any dass of object, including an array: 



Code section 3.56: Two-dimensional arrays. 

;-l 


ll 

String [] 

[ ] twoDimArray = 

= { { 

II II 

ä , 

"b" 

r 

H r, H 

° r 

"d", "e" 

}, 

■2 



{ 

II -p II 

L r 

"g" 

r 

"h". 

II 4 II II f II 

r J 

}, 

13 



{ 

" k " , 

ii ^ ii 

r 

"m". 

" n " , " o " 

}}; 

■5 

int [] [] 

twoDimlntArray = 

= { { 

0, 

i. 

2 

, 3, 

4}, 


|6 



{ 

10, 

ii. 

12 

, 13, 

14}, 


■7 



{ 

20, 

21, 

22 

, 23, 

2 4}}; 



L 


It’s not exactly equivalent to two-dimensional arrays because the size of the sub-arrays may vary. The sub-array reference can even be null. Consider: 



Code section 3.57: Weird two-dimensional array. 

I-, 


!l String [] [] weirdTwoDimArr ay = {{"10", "11", "12"}, 

[2 null, 

|3 {"20", "21", "22", "23", "24"}}; 


L 


J 


Note that the length of a two-dimensional array is the number of one-dimensional arrays it contains. In the above example, weirdTwoDimArray. length is 3, whereas 

weirdTwoDimArray [ 2 ] . length is 5. 


In the code section 3.58, we defined an array that has three elements, each element contains an array having 5 elements. We could create the array having the 5 elements first and 
use that one in the initialize block. 


m 


Code section 3.58: Included array. 


|1 String[] oneDimArray = {"00", "01", "02", "03", "04"}; 

i2 String [] [] twoDimArray = {oneDimArray, 

|3 { " 10 " , " 11 " , " 12 " , " 13 " , " 14 " } , 

■4 { " 2 0 " , " 21 " , " 2 2 " , " 2 3 " , " 2 4 " } } ; 


Test your knowledge 

Question 3.21: Consider the following code: 




Question 3.21: The alphabet. 


■1 String [] [] alphabet = - 

[{"a", ' 

’b". 

" c f 

', "d 1 

" , " e' 



i2 

{ "f' 

1 II 

t 

g". 

"h". 

II 4 II 

- L r 

II j II 

}, 

[3 

{ "k' 

1 II 

t 

i". 

"m". 

" n " , 

II 0 II 

}, 

i4 

{ "P' 

1 II 

t 

q". 

II r II 

t 

II 0 ” 

0 r 

"t" 

}, 

[5 

{ "u' 

1 II 

t 

V", 

"w ", 

" X " , 

"y " 

}, 

■6 

{ "z' 

'} }; 







Print the whole alphabet in the Standard output. 
Answer 

Question 3.21: Answer21.java 


1 

public dass Answer21 

{ 




2 

public static void 

main (String[] args) 

{ 


3 

Stringf][] alphabet = {{"a", "b". 

II c II 

, " d " 

, "e"} 

4 


Pf", "g". 

"h". 

ll 4 ll 

- 1 - r 

" j " }, 

5 


{ " k " , " 1" , 

"m". 

" n " , 

" 0 "}, 

6 


Pp", "q". 

II y~ II 

1- f 

II 0 »» 

^ r 

"t"}. 

7 


{"u", "v". 

"w". 

" X " , 

"y"}. 

8 


{ " z" }}; 




9 






10 

for (int i = 0; i 

< alphabet.length; 

i++) 

{ 

11 

for (int j = 0; 

j < alphabet[i] 

. length; 

j++) { 


System. out . println (alphabet [ i] [ j]) ; 
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!l 2 13 } 

il 4 } 

il5 } 

Il 6 } 


i will be the indexes of the main array and j will be the indexes of all the sub-arrays. We have to first iterate on the main array. We have to read the size of the array. Then we 
iterate on each sub-array. We have to read the size of each array as it may vary. Doing so, we iterate on all the sub-array items using the indexes. All the items will be read in 
the right Order. 


Multidimensional Array 

Going further any number of dimensional array can be defined. 

element Type [1 []...[] array Name 
or 

elementType array Name [][]...[] 


Mathematical functions 

The java. lang. Math dass allows the use of many common mathematical functions that can be used while creating programs. 

Since it is in the java. lang package, the Math dass does not need to be imported. However, in programs extensively utilizing these functions, a static import can be used. 

Math constants 

There are two constants in the Math dass that are fairly accurate approximations of irrational mathematical numbers. 

Math.E 

The Math. e constant represents the value of Euler's number (e), the base of the natural logarithm. 




Code section 3.20: Math. e 


■1 public static final double E = 2.718281828459045; i 


Math.PI 

The Math .pi constant represents the value of pi, the ratio of a circle's circumference to its diameter. 


m 


Code section 3.21: Math. pi 


■1 public static final double PI = 3.141592653589793;i 


Math methods 

Exponential methods 

There are several methods in the Math dass that deal with exponential functions. 

Exponentiation 

The power method, double Mat h.pow (double, double) , returns the first parameter to the power of the second parameter. For example, a call to Math .pow (2, io) willreturna 
value of 1024 (2 10 ). 

The Math. exp (double) method, a special case of pow, returns e to the power of the parameter. In addition, double Math. expmi (double) returns ( e x - 1). Both of these methods 
are more accurate and convenient in these special cases. 

Java also provides special cases of the pow function for square roots and cube roots of doubles, double Math. sqrt (double) and double Math. cbrt (double). 

Logarithms 

Java has no general logarithm function; when needed this can be simulated using the change-of-base theorem. 

double Math. log (double) returns the natural logarithm of the parameter (not the common logarithm, as its name suggests!). 

double Math. logio (double) returns the common (base-10) logarithm of the parameter. 

double Math. logip (double) returns ln(parameter+l). It is recommended for small values. 

Trigonometrie and hyperbolic methods 

The trigonometric methods of the Math dass allow users to easily deal with trigonometric functions in programs. All accept only doubles. Please note that all values using these 
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methods are initially passed and returned in radians, not degrees. However, conversions are possible. 

Trigonometrie functions 

The three main trigonometric methods are Math. sin (x) , Math. cos (x) , and Math . tan (x) , which are used to find the sine, cosine, and tangent, respectively, of any given number. 
So, for example, a call to Math, sin (Math.pi/ 2 ) would return a value of about 1. Although methods for finding the cosecant, secant, and cotangent are not available, these values 
can be found by taking the reciprocal of the sine, cosine, and tangent, respectively. For example, the cosecant of pi/2 could be found using l/Math. sin (Math. pi/2 ). 

Inverse trigonometric functions 

Java provides inverse counterparts to the trigonometric functions: Math. asin (x) , and Math. acos (x), Math. atan (x) . 


Hyperbolic functions 

In addition, hyperbolic functions are available: Math, sinh (x), Math. cosh (x) , and Math. tanh (x). 

Radian/degree conversion 

To convert between degree and radian measures of angles, two methods are available, Math . toRadians (x) and Math . toDegrees (x) . While using Math. toRadians (x) , a degrees 
value must be passed in, and that value in radians (the degree value multiplied by pi/180) will be returned. The Math. toDegrees (x) method takes in a value in radians and the 
value in degrees (the radian value multiplied by 180/pi) is returned. 

Absolute value: Math. abs 


The absolute value method of the Math dass is compatible with the int, long, float, and double types. The data returned is the absolute value of parameter (how far away it is 
from zero) in the same data type. For example: 



Code section 3.22: Math. abs 

1 -1 

|1 int result = Math . abs (-3) ; i 

I_i 


In this example, result will contain a value of 3. 

Maximum and minimum values 

These methods are very simple comparing functions. Instead of using if ...eise Statements, one can use the Math. max (xi, x2) and Math. min (xi, x2) methods. The 

Math. max (xi, x2 ) simply returns the greater of the two values, while the Math. min (xi, x2 ) returns the lesser of the two. Acceptable types for these methods include int, long, 

float, and double. 

Functions dealing with floating-point representation 

Java 1.5 and 1.6 introduced several non-mathematical functions specific to the Computer floating-point representation of numbers. 

Math. ulp (double) and Math. ulp (float) return an ulp, the smallest value which, when added to the argument, would be recognized as larger than the argument. 

Math. copysign returns the value of the first argument with the sign of the second argument. It can be used to determine the sign of a zero value. 

Math. getExponent returns (as an int) the exponent used to scale the floating-point argument in Computer representation. 

Rounding number example 

Sometimes, we are not only interested in mathematically correct rounded numbers, but we want that a fixed number of significant digits are always displayed, regardless of the 
number used. Here is an example program that returns always the correct string. You are invited to modify it such that it does the same and is simpler! 

The constant dass contains repeating constants that should exist only once in the code so that to avoid inadvertent changes. (If the one constant is changed inadvertently, it is most 
likely to be seen, as it is used at several locations.) 

Code listing 3.20: StringUtils.java 


1 /** 

2 * dass that comprises of constant values & string Utilities. 

3 * 

4 * Ssince 2013-09-05 

5 * Qversion 2014-10-14 

6 */ 

7 public dass StringUtils { 

8 /** Dash or minus constant */ 

9 public static final char DASH = 

10 /** The exponent sign in a scientific number, or the Capital letter E */ 

11 public static final char EXPONENT = 'E'; 

12 /** The full stop or period */ 

13 public static final char PERIOD = '.' ; 

14 /** The zero string constant used at several places */ 

15 public static final String ZERO = "0"; 

16 

17 /** 

18 * Removes all occurrences of the filter character in the text. 

19 * 

20 * @param text Text to be filtered 

21 * Sparam filter The character to be removed. 

22 * @return the string 

23 V 

24 public static String filter (final String text, final String filter) { 

25 final String [] words = text. split ( " [" + filter + 

26 

27 switch (words. length) { 

28 case 0: return text; 
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29 case 1: return words[0]; 

30 default : 

31 final StringBuilder filteredText = new StringBuilder(); 

32 

33 for (final String word : words) { 

34 filteredText. append (word); 

35 } 

36 

37 return filteredText .toString (); 

38 } 

39 } 

40 } 


The MathsUtils dass is like an addition to the java. lang. Math dass and contains the rounding calculations. 

Code listing 3.21: MathsUtils.java 


1 package string; 

2 

3 /** 

4 * dass for special mathematical calculations. <br/> 

5 * ATTENTION:<br/>Should depend only on Standard Java libraries! 

6 * 

7 * Ssince 2013-09-05 

8 * Qversion 2014-10-14 

9 V 

10 public dass MathsUtils { 

11 

12 // CONSTANTS 

13 // - 

14 

15 /** The exponent sign in a scientific number, or the Capital letter E. */ 

16 public static final char EXPONENT = ' E'; 

17 

18 /** Value after which the language switches from scientific to double */ 

19 private static final double E_TO_DOUBLE = 1E-3; 

20 

21 /** The zero string constant used at several places. */ 

22 public static final String ZERO = "0"; 

23 

24 /** The string of zeros */ 

25 private static final String ZEROS = "000000000000000000000000000000000"; 

26 

27 // METHODS 

2 8 // - 

29 

30 /** 

31 * Determines, if the number uses a scientific representation. 

32 * 

33 * @param number the number 

34 * @return true, if it is a scientific number, false otherwise 

35 */ 

36 private static boolean isScientific (final double number) { 

37 return ((new Double(number)) .toString (). indexOf (EXPONENT) > 0); 

38 } 

39 

40 /** 

41 * Determines how many zeros are to be appended after the decimal digits. 

42 * 

43 * @param significantsAfter Requested significant digits after decimal 

44 * Qparam Separator Language-specific decimal Separator 

45 * Sparam number Rounded number 

46 * Sreturn Requested value 

47 */ 

48 private static byte calculateMissingSignificantZeros ( 

49 final byte significantsAfter, 

50 final char Separator, 

51 final double number) { 

52 

53 final byte after = findSignificantsAfterDecimal(Separator, number); 

54 

55 final byte zeros = 

56 (byte) (significantsAfter - ((after == 0) ? 1 : after)); 

57 

58 return ((zeros >= 0) ? zeros : 0); 

59 } 

60 

61 /** 

62 * Finds the insignificant zeros after the decimal Separator. 

63 * 

64 * @param Separator Language-specific decimal Separator 

65 * @param number the number 

66 * Sreturn the byte 

67 V 

68 private static byte findlnsignificantZerosAfterDecimal ( 

69 final char Separator, 

70 final double number) { 

71 

72 if ((Math. abs (number) >= 1) || isScientific(number)) { 

73 return 0; 

74 } eise { 

75 final StringBuilder string = new StringBuilder(); 

76 

77 string. append (number); 

78 string. delete (0, 

79 string. indexOf (new Character(Separator). toString ()) + 1); 

80 

81 // Determine what to match: 

82 final String regularExpression = "[1-9]"; 

83 

84 final String[] split = string. toString (). split (regularExpression); 


101 sur 134 


30/01/2016 20:09 












Java Programming/Print Version - Wikibooks, openbooks for an open worldhttps://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve 


85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 

103 

104 

105 

106 

107 

108 

109 

110 
111 
112 

113 

114 

115 

116 

117 

118 

119 

120 
121 
122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 

159 

160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 
189 


return (split. length > 0) ? (byte) split[0]. length () : 0; 

} 

} 

/ k k 

* Calculates the number of all significant digits (without the sign and 

* the decimal Separator). 

k 

* ßparam significantsAfter Requested significant digits after decimal 

* @param Separator Language-specific decimal Separator 

* Sparam number Value where the digits are to be counted 

* Sreturn Number of significant digits 
*/ 

private static byte findSignificantDigits (final byte significantsAfter, 
final char Separator, 
final double number) { 

if (number == 0) { return 0; } 

eise { 

String mantissa = 

findMantissa(Separator, new Double(number) . toString () ) ; 

if (number == ( long )number) { 

mantissa = mantissa. substring (0, mantissa. length () - 1); 

} 

mantissa = retrieveDigits(Separator, mantissa); 

// Find the position of the first non-zero digit: 
short nonZeroAt = 0; 

for (; (nonZeroAt < mantissa. length () ) 

&& (mantissa. charAt (nonZeroAt) == '0'); nonZeroAt++) ; 

return (byte) mantissa. substring (nonZeroAt). length (); 

} 

} 

/ k k 

* Determines the number of significant digits after the decimal Separator 

* knowing the total number of significant digits and the number before the 

* decimal Separator. 

k 

* @param significantsBefore Number of significant digits before Separator 

* Sparam significantDigits Number of all significant digits 

* @return Number of significant decimals after the Separator 
*/ 

private static byte findSignificantsAfterDecimal ( 
final byte significantsBefore, 
final byte significantDigits) { 

final byte afterDecimal = 

(byte) (significantDigits - significantsBefore); 

return (byte) ((afterDecimal > 0) ? afterDecimal : 0); 

} 

/ k k 

* Determines the number of digits before the decimal point. 

k 

* Sparam Separator Language-specific decimal Separator 

* ßparam number Value to be scrutinised 

* Qreturn Number of digits before the decimal Separator 
*/ 

private static byte findSignificantsBeforeDecimal (final char Separator, 

final double number) { 

final String value = new Double(number). toString (); 

// Return immediately, if result is clear: Special handling at 
// crossroads of floating point and exponential numbers: 

if ((number == 0) || (Math. abs (number) >= E_TO_DOUBLE) 

&& (Math. abs (number) < 1)) { 

return 0; 

} eise if ((Math. abs (number) >0) && (Math. abs (number) < E_TO_DOUBLE)) { 

return 1; 

} eise { 

byte significants = 0; 

// Significant digits to the right of decimal Separator: 
for (byte b = 0; b < value. length (); b++) { 

if (value. charAt (b) == Separator) { 

break; 

} eise if (value. charAt (b) != StringUtils. DASH ) { 

significant s + + ; 

} 

} 

return significants; 

} 

} 

/ k k 

* Returns the exponent part of the double number. 

k 

* Sparam number Value of which the exponent is of interest 

* @return Exponent of the number or zero. 

* / 

private static short findExponent ( final double number) { 

return new Short(findExponent( (new Double(number)) .toString ())); 

} 

/ k k 

* Finds the exponent of a number. 

k 
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190 

191 

192 

193 

194 

195 

196 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 

207 

208 

209 

210 
211 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 

251 

252 

253 

254 

255 

256 

257 

258 

259 

260 
261 
262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 

274 

275 

276 

277 

278 

279 

280 
281 
282 

283 

284 

285 

286 

287 

288 

289 

290 

291 

292 

293 

294 


* Sparam value Value where an exponent is to be searched 

* @return Exponent, if it exists, or "0". 

*/ 

private static String findExponent ( final String value) { 

final short exponentAt = (short) value. indexOf (EXPONENT); 

if (exponentAt < 0) { return ZERO; } 

eise { 

return value. substring (exponentAt + 1); 

} 


/ k k 

* Finds the mantissa of a number. 

k 

* Sparam Separator Language-specific decimal Separator 

* @param value Value where the mantissa is to be found 

* Sreturn Mantissa of the number 

* / 

private static String findMantissa ( final char Separator, 

final String value) { 

String strValue = value; 

final short exponentAt = (short) strValue. indexOf (EXPONENT); 
if (exponentAt > -1) { 

strValue = strValue. substring (0, exponentAt); 

} 

return strValue; 

} 

/ k k 

* Retrieves the digits of the value without decimal Separator or sign. 

k 

* Sparam Separator 

* @param number Mantissa to be scrutinised 

* Sreturn The digits only 
*/ 

private static String retrieveDigits ( final char Separator, String number) { 
// Strip off exponent part, if it exists: 
short eAt = ( short )number. indexOf (EXPONENT); 

if (eAt > -1) { 

number = number. substring (0, eAt); 

} 


} 


return number. replace ( (new Character(StringUtils.DASH)) .toString (), ""). 

replace( (new Character(Separator)). toString (), ""); 


// - Public methods 


/ k k 

* Returns the number of digits in the long value. 

k 

* Sparam value the value 

* Sreturn the byte 
*/ 

public static byte digits (final long value) { 

return (byte) StringUtils. filter (Long. toString (value), ".,"). length (); 

} 

/ k k 

* Finds the significant digits after the decimal Separator of a mantissa. 

k 

* @param Separator Language-specific decimal Separator 

* Sparam number Value to be scrutinised 

* Sreturn Number of significant zeros after decimal Separator. 

* / 

public static byte findSignificantsAfterDecimal (final char Separator, 

final double number) { 


if (number == 0) { return 1; } 

eise { 

String value = (new Double(number)) .toString (); 

final short separatorAt = (short) value. indexOf (Separator); 

if (separatorAt > -1) { 

value = value. substring (separatorAt + 1); 

} 

final short exponentAt = (short) value. indexOf (EXPONENT); 

if (exponentAt >0) { 

value = value. substring (0, exponentAt); 

} 

final Long longValue = new Long(value). longValue () ; 

if (Math. abs (number) < 1) { 

return (byte) longValue. toString (). length (); 

} eise if (longValue == 0) { 

return 0; 

} eise { 

return (byte) (("0." + value). length () - 2); 

} 

} 

} 

/ k k 

* Calculates the power of the base to the exponent without changing the 

* least-significant digits of a number. 
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295 

296 

297 

298 

299 

300 

301 

302 

303 

304 

305 

306 

307 

308 

309 

310 

311 

312 

313 

314 

315 

316 

317 

318 

319 

320 

321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 

349 

350 

351 

352 

353 

354 

355 

356 

357 

358 

359 

360 

361 

362 

363 

364 

365 

366 

367 

368 

369 

370 

371 

372 

373 

374 

375 

376 

377 

378 

379 

380 

381 

382 

383 

384 

385 

386 

387 

388 

389 

390 

391 

392 

393 

394 

395 

396 

397 

398 

399 


k 

* Sparam basis 

* @param exponent 

* @return basis to power of exponent 

* / 

public static double power (final int basis, final short exponent) { 
return power(( short ) basis, exponent); 

} 

/ k k 

* Calculates the power of the base to the exponent without changing the 

* least-significant digits of a number. 

k 

* Sparam basis the basis 

* Sparam exponent the exponent 

* Sreturn basis to power of exponent 
*/ 

public static double power (final short basis, final short exponent) { 
if (basis == 0) { 

return (exponent != 0) ? 1 : 0; 

} eise { 

if (exponent == 0) { 

return 1 ; 

} eise { 

// The Math method power does change the least significant 
// digits after the decimal Separator and is therefore useless. 
double result = 1; 
short s = 0; 


if (exponent > 0) { 

for (; s < exponent; s++) { 

result *= basis; 

} 


} eise if (exponent < 0) { 

for (s = exponent; s < 0; s++) 

result /= basis; 

} 


{ 


} 


} 


return result; 


/ k k 

* Rounds a number to the decimal places. 

k 

* Sparam significantsAfter Requested significant digits after decimal 

* Sparam Separator Language-specific decimal Separator 

* Sparam number Number to be rounded 

* Sreturn Rounded number to the requested decimal places 
*/ 

public static double round (final byte significantsAfter, 

final char Separator, 
final double number) { 


if (number == 0) { return 0; } 

eise { 

final double constant = power(10, (short) 

(findlnsignificantZerosAfterDecimal(Separator, number) 

+ significantsAfter)); 

final short dExponent = findExponent(number); 
short exponent = dExponent; 

double value = number*constant*Math. pow (10, -exponent); 
final String exponentSign = 

(exponent < 0) ? String. valueOf (StringUtils. DASH) : 

if (exponent != 0) { 

exponent = (short) Math. abs (exponent); 

value = round(value); 

} eise { 

value = round(value)/constant; 

} 

// Power method cannot be used, as the exponentiated number may 
// exceed the maximal long value. 

exponent -= Math. signum (dExponent)*(findSignificantDigits 
(significantsAfter, Separator, value) - 1); 

if (dExponent != 0) { 

String strValue = Double. toString (value); 

strValue = strValue. substring (0, strValue. indexOf (Separator)) 
+ EXPONENT + exponentSign + Short . toString (exponent) ; 

value = new Double(strValue); 

} 


return value; 

} 

} 

/ k k 

* Rounds a number according to mathematical rules. 

k 

* Sparam value the value 

* Sreturn the double 
*/ 

public static double round (final double value) { 
return (long) (value + .5); 

} 
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* Rounds to a fixed number of significant digits. 

k 

* @param significantDigits Requested number of significant digits 

* Sparam Separator Language-specific decimal Separator 

* @param dNumber Number to be rounded 

* @return Rounded number 
*/ 

public static String roundToString ( final byte significantDigits, 

final char Separator, 
double dNumber) { 

// Number of significants that *are* before the decimal Separator: 
final byte significantsBefore = 

findSignificantsBeforeDecimal(Separator, dNumber); 

// Number of decimals that *should* be after the decimal Separator: 
final byte significantsAfter = findSignificantsAfterDecimal( 
significantsBefore, significantDigits); 

// Round to the specified number of digits after decimal Separator: 

final double rounded = MathsUtils. round (significantsAfter, Separator, dNumber); 

final String exponent = findExponent( (new Double(rounded)). toString ()); 
final String mantissa = findMantissa(Separator, 

(new Double(rounded) ) .toString () ); 

final double dMantissa = new Double(mantissa). doubleValue (); 
final StringBuilder result = new StringBuilder(mantissa); 

// Determine the significant digits in this number: 

final byte significants = findSignificantDigits(significantsAfter, 

Separator, dMantissa); 

// Add lagging zeros, if necessary: 
if (significants <= significantDigits) { 
if (significantsAfter != 0) { 

result. append (ZEROS. substring (0, 

calculateMissingSignificantZeros(significantsAfter, 

Separator, dMantissa))); 

} eise { 

// Cut off the decimal Separator & after decimal digits: 
final short decimal = (short) result. indexOf ( 
new Character(Separator) .toStringO ) ; 

if (decimal > -1) { 

result. setLength (decimal); 


} 


} 


} eise if (significantsBefore > significantDigits) { 

dNumber /= power(10, (short) (significantsBefore - significantDigits)); 

dNumber = round(dNumber); 

final short digits = 

(short) (significantDigits + ( (dNumber < 0) ? 1 : 0) ) ; 

final String strDouble = (new Double(dNumber)) .toString (). substring (0, digits); 
result. setLength (0) ; 

result. append (strDouble + ZEROS. substring (0, 

significantsBefore - significantDigits)); 

} 

if (new Short(exponent) != 0) { 

result. append (EXPONENT + exponent); 

} 

return result. toString (); 

} // public static String roundToString (...) 

/ k k 

* Rounds to a fixed number of significant digits. 

k 

* Sparam Separator Language-specific decimal Separator 

* Sparam significantDigits Requested number of significant digits 

* ßparam value Number to be rounded 

* @return Rounded number 
*/ 

public static String roundToString ( final char Separator, 

final int significantDigits, 
float value) { 

return roundToString( (byte) significantDigits, Separator, 

(double) value); 

} 

} // dass MathsUtils 


I- 


The code is tested with the following JUnit test: 


Code listing 3.22: MathslItilsTest. java 


1 package string; 

2 

3 Import static org.junit.Assert.assertEquals; 

4 import static org. junit .Assert.assertFalse; 

5 import static org. junit .Assert.assertTrue; 

6 

7 import java.util.Vector ; 

8 

9 import org.junit.Test; 

10 

11 /** 

12 * The JUnit test for the <code>MathsUtils</code> dass. 

13 * 
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! 14 

* Ssince 2013-03-26 



! 15 

* Qversion 2014-10-14 



i 16 

*/ 



! 17 

public dass MathsUtilsTest { 



! 18 




! 19 

/ k k 



! 20 

* Method that adds a negative and a positive value to values. 



! 21 

k 



! 22 

* Sparam d the double value 



! 23 

* @param values the values 



! 24 

* / 



i 25 

private static void addValue ( final double d, Vector<Double> values) 

{ 


i 26 

values. add (-d); 



i 27 

values. add (d); 



■ 28 

} 



i 29 




■ 30 

// Public methods 



' 31 




' 32 

/ k k 



' 33 

* Tests the round method with a double parameter. 



' 34 

*/ 



' 35 

@Test 



' 36 

public void testRoundToStringDoubleByteCharDouble () { 



' 37 

// Test rounding 



' 38 

final Vector<Double> values = new Vector<Double>(); 



• 39 

final Vector<String> strValues = new Vector<String>(); 



' 40 




' 41 

values. add ( 0 . 0 ); 



' 42 

strValues. add ("0.00000") ; 



' 43 

addValue(1.4012984643248202e-45, values); 



i 44 

strValues. add ( "-1.4012E-45") ; 



1 45 

strValues. add ( " 1 .4013E-45" ); 



1 46 

addValue(1.999999757e-5, values); 



1 47 

strValues. add ("-1.9999E-5") ; 



1 48 

strValues. add ( "2.0000E-5" ); 



1 49 

i 

addValue(1.999999757e-4, values); 



1 50 

strValues. add ("-1.9999E-4") ; 



1 51 

i 

strValues. add ( "2.0000E-4" ); 



' 52 

i 

addValue(1.999999757e-3, values); 



1 53 

i 

strValues. add ( "-0.0019999" ) ; 



1 54 

i 

strValues. add ("0.0020 000") ; 



1 55 

i 

addValue(0.000640589, values); 



' 56 

i 

strValues. add ( " - 6 . 4 058E-4 " ); 



' 57 

i 

strValues. add ( "6.4059E-4" ); 



' 58 

i 

addValue(0.3396899998188019, values); 



1 59 

i 

strValues. add ( "-0. 33968 " ) ; 



! 60 

strValues. add ("0.33969") ; 



! 61 

addValue(0.34, values); 



! 62 

strValues. add ( "-0.33999" ) ; 



! 63 

strValues. add ("0.34000") ; 



; 64 

addValue(7.07, values); 



! 65 

strValues. add ( "-7.0699" ) ; 



; 66 

strValues. add ("7. 07 00") ; 



! 67 

addValue(118.188, values); 



! 68 

strValues. add ("-118.18") ; 



; 69 

strValues. add ("118.19") ; 



; 70 

addValue(118.2, values); 



! 71 

strValues. add ("-118.19"); 



| 72 

strValues. add ("118.20") ; 



: 73 

addValue(123.405009, values); 



1 74 

strValues. add ("-123.40") ; 



! 75 

strValues. add ("123.41") ; 



! 76 

addValue(30.76994323730469, values) ; 



[ 77 

strValues. add ( " -30 . 7 6 9 " ); 



! 78 

strValues. add ("30.770"); 



! 79 

addValue(130.76994323730469, values); 



J 80 

strValues. add ("-130.76") ; 



! 81 

strValues. add (" 130.77") ; 



J 82 

addValue(540, values); 



| 83 

strValues. add ( "-539.99" ) ; 



! 84 

strValues. add ("540.00") ; 



| 85 

addValue(12345, values); 



| 86 

strValues. add ( "-12344" ); 



! 8 7 

strValues. add (" 12345 " ) ; 



| 88 

addValue(123456, values); 



! 89 

strValues. add ( " -1234 50" ) ; 



! 90 

strValues. add ( " 123460 " ) ; 



! 91 

addValue ( 540911, values); 



! 92 

strValues. add ( "-540900" ); 



! 93 

strValues. add ( "540910" ); 



! 94 

addValue(9.223372036854776e56, values) ; 



! 95 

strValues. add ( "-9.2233E56" ); 



! 96 

strValues. add ( " 9 . 2234E56" ) ; 



! 97 




! 98 

byte i = 0 ; 



! 99 

final byte significants = 5; 



!l 0 0 




!i o i 

for (final double element : values) { 



!l 02 

final String strValue; 



il 0 3 




!l 0 4 

try { 



Il 0 5 

strValue = MathsUtils. roundToString (significants, StringUtils.PERIOD, 

element );j 

Il 0 6 




Il 0 7 

System. out . printin ( " MathsUti1s . round ( " + significants 

_i_ II 1 II 

' r 


Il 0 8 

+ StringUtils. PERIOD + "', " + element + ") ==> 

ii 


Il 0 9 

+ strValue + " = " + strValues. get ( i )); 



Il 10 

assertEquals( "Testing roundToString", strValue, strValues. get (i++)); 


Im 

} catch (final Exception e) { 



Il 12 

// TODO Auto-generated catch block 



111 3 

e.printStackTrace () ; 



In 4 

} 



il 15 

} 



ill 6 

} 



il 17 




ill 8 

i 

l_ 

} // dass MathsUtilsTest 
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The output of the JUnit test follows: 


Output for code listing 3.22 


MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 
MathsUtils.round(5, 


, 0.0) ==> 0 .00000 = 0 .00000 

, -1 . 4012984643248202E-45) ==> -1.4012E-45 = -1.4012E-45 
, 1 . 4012984643248202E-45) = = > 1.4013E-45 = 1.4013E-45 

, -1.999999757E-5) ==> -1.9999E-5 = -1.9999E-5 
, 1 . 999999757E-5) ==> 2.0000E-5 = 2.0000E-5 
, -1.999999757E-4) ==> -1.9999E-4 = -1.9999E-4 
, 1 . 999999757E-4) = = > 2.0000E-4 = 2.0000E-4 

, -0.001999999757) ==> -0.0019999 = -0.0019999 
, 0.001999999757) ==> 0.0020000 = 0.0020000 
, -6.40589E-4) ==> -6.4058E-4 = -6.4058E-4 

, 6.40589E-4) ==> 6.4059E-4 = 6.4059E-4 

, -0.3396899998188019) ==> -0.33968 = -0.33968 
, 0.3396899998188019) ==> 0.33969 = 0.33969 
, -0.34) ==> -0.33999 = -0.33999 
, 0.34) ==> 0.34000 = 0.34000 
, -7.07) ==> -7.0699 = -7.0699 
, 7.07) ==> 7.0700 = 7.0700 
, -118.188) ==> -118.18 = -118.18 
, 118.188) ==> 118.19 = 118.19 

, -118.2) ==> -118.19 = -118.19 
, 118.2) ==> 118.20 = 118.20 
, -123.405009) ==> -123.40 = -123.40 
, 123.405009) ==> 123.41 = 123.41 

, -30.76994323730469) ==> -30.769 = -30.769 
, 30.76994323730469) ==> 30.770 = 30.770 
, -130.7699432373047) ==> -130.76 = -130.76 
, 130.7699432373047) ==> 130.77 = 130.77 

, -540.0) ==> -539.99 = -539.99 
, 540.0) ==> 540.00 = 540.00 
, -12345.0) ==> -12344 = -12344 
, 12345.0) ==> 12345 = 12345 
, -123456.0) ==> -123450 = -123450 
, 123456.0) ==> 123460 = 123460 
, -540911.0) ==> -540900 = -540900 
, 540911.0) ==> 540910 = 540910 

, -9.223372036854776E56) ==> -9.2233E56 = -9.2233E56 
, 9.223372036854776E56) ==> 9.2234E56 = 9.2234E56 


If you are interested in a comparison with C#, take a look at the rounding number example there. If you are interested in a comparison with C++, you can compare this code here 
with the same example over there. 

Notice that in the expression starting with if ( (d == o ), I have to use OR instead of the | | because of a bug in the source template. 


Large numbers 

The integer primitive type with the largest ränge of value is the long, from -2 63 to 2 63 -l. If you need greater or lesser values, you have to use the Biginteger dass in the package 
java. math. A Biginteger object can represent any integer (as large as the RAM on the Computer can hold) as it is not mapped on a primitive type. Respectively, you need to use 
the BigDecimai dass for great decimal numbers. 

However, as these perform much slower than primitive types, it is recommended to use primitive types when it is possible. 

Biginteger 

The Biginteger dass represents integers of almost any size. As with other objects, they need to be constructed. Unlike regulär numbers, the Biginteger represents an immutable 
object - methods in use by the Biginteger dass will return a new copy of a Biginteger. 

To instantiate a Biginteger, you can create it from either byte array, or from a String. For example: 

Code section 3.23: 1 quintillion, or 10 A 18. Too large to fit in a long. 

' -! 

■1 Biginteger i = new Biginteger( "1000000000000000000" ); i 

l-1 



Biginteger cannot use the normal Java operators. They use the methods provided by the dass. 



Code section 3.24: Multiplications and an addition. 

i-n 


!l Biginteger a = new Biginteger (" 3 ") ; 

'2 Biginteger b = new Biginteger (" 4") ; 

>3 

[4 // c = a*2 + b*2 

■5 Biginteger c = a. multiply (a) . add (b. multiply (b) ) ; 

L_ 


It is possible to convert to a long, but the long may not be large enough. 



Code section 3.25: Conversion. 

\ -, 

[l Biginteger aBiglnteger = new Biginteger ("3") ;i 

■2 long aLong = aBiglnteger . longValue () ; , 

I_! 


BigDecimai 
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The Biginteger dass cannot handle decimal numbers. The BigDecimai dass represents a floating point value of arbitrary precision. It is composed of both a Biginteger, and a 
scale value (represented by a 32-bit integer). 


Random numbers 

To generate random numbers the Math. random () method can be used, which returns a double, greater than or equal to 0.0 and less than 1.0. 
The following code returns a random integer between n and m (where n <= randomNumber < in): 


m 


Code section 3.30: A random integer. 


■1 int randomNumber = n + (int) (Math. random () * ( m — n ));i 


Alternatively, the java. utii. Random dass provides methods for generating random booleans, bytes, floats, ints, longs and ’Gaussians' (doubies from a normal distribution 
with mean 0.0 and Standard deviation 1.0). For example, the following code is equivalent to that above: 


m 


Code section 3.31: A random integer with Gaussian. 


,1 Random random = new Random () ; 

■2 int randomNumber = n + random. nextInt (m - n); 


As an example using random numbers, we can make a program that uses a Random object to simulate flipping a coin 20 times: 


Code listing 3.25: CoinFlipper.java 


1 Import java.util.Random; 


3 public dass CoinFlipper { 


5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 } 


public static void main (String[] args) { 
// The number of times to flip the coin 
final int TIMES_TO_FLIP = 20; 
int heads = 0; 
int tails = 0; 

// Create a Random object 
Random random = new Random(); 
for (int i = 0; i < TIMES_TO_FLIP; i++) 

// 0 or 1 

int result = random. nextInt (2) ; 
if (result == 1) { 

System. out .printin ( "Heads" ); 
heads++; 

} eise { 

System.out. printin (" Tails") ; 
t a i 1 s + + ; 


} 


} 


System. out . println (" There were 
+ heads 

+ " heads and " 

+ tails 
+ " tails"); 


Possible output for code listing 3.25 

iHeads 
iT a i 1 s 
iT a i 1 s 
iT a i 1 s 
iHeads 
iT a i 1 s 
iHeads 
iHeads 
iHeads 
iHeads 
iHeads 
iHeads 
iT a i 1 s 
iT a i 1 s 
iT a i 1 s 
iT a i 1 s 
iHeads 
iT a i 1 s 
iT a i 1 s 
iT a i 1 s 

iThere were 9 heads and 11 tails 


I. 


Of course, if you run the program you will probably get different results. 

Truly random numbers 

Both Math. random () and the Random dass produce pseudorandom numbers. This is good enough for a lot of applications, but remember that it is not truly random. If you want a 
more secure random number generator, Java provides the java. security. secureRandom package. What happens with Math. random () and the Random dass is that a 'seed’ is 
chosen from which the pseudorandom numbers are generated. SecureRandom increases the security to ensure that the seed which is used by the pseudorandom number generator is 
non-deterministic — that is, you cannot simply put the machine in the same state to get the same set of results. Once you have created a SecureRandom instance, you can use it in 
the same way as you can the Random dass. 

If you want truly random numbers, you can get a hardware random number generator or use a randomness generation Service. 


Unicode 


Most Java program text consists of ASCII characters, but any Unicode character can be used as part of identifier names, in comments, and in character and string literals. For 
example, n (which is the Greek Lowercase Letter pi) is a valid Java identifier: 



Code section 3.100: Pi. 

1 -1 

■1 double n = Math. PI; i 

i-1 


and in a string literal: 
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Code section 3.101: Pi literal. 

■-1 

■1 String pi = "n"; i 

I_i 


Unicode escape sequences 


Unicode characters can also be expressed through Unicode Escape Sequences. Unicode escape sequence may appear anywhere in a Java source file (including inside identifiers, 
comments, and string literals). 

Unicode escape sequences consist of 

1. a backslash V (ASCII character 92, hex 0x5c), 

2. aV (ASCII 117, hex 0x75) 

3. optionally one or more additional 'u' characters, and 

4. four hexadecimal digits (the characters 'o' through '9' or 'a' through ’f ’ or 'a' through ’f'). 

Such sequences represent the UTF-16 encoding of a Unicode character. For example, ’a’ is equivalent to '\u006F. This escape method does not support characters beyond U+FFFF 
or you have to make use of Surrogate pairsJ 1 ! 

Any and all characters in a program may be expressed in Unicode escape characters, but such programs are not very readable, except by the Java Compiler - in addition, they are not 
very compact. 

One can find a full list of the characters here. 


71 may also be represented in Java as the Unicode escape sequence \u 03 co. Thus, the following is a valid, but not very readable, declaration and assignment: 



Code section 3.102: Unicode escape sequences for Pi. 

■- 1 

|1 double \u03C0 = Math.PI; i 

1_1 


The following demonstrates the use of Unicode escape sequences in other Java syntax: 


m 


Code section 3.103: Unicode escape sequences in a string literal. 

1 - 

il // Declare Strings pi and quote which contain \u03C0 and \u0027 respectively :i 
[2 String pi = "\u03C0"; 

■3 String quote = "\u0027"; 


Note that a Unicode escape sequence functions just like any other character in the source Code. E.g., \u0022 (double quote, ") needs to be quoted in a string just like ". 


Code section 3.104: Double quote. 

1-1 

il // Declare Strings doubleQuotel and doubleQuote2 which both contain " (double quote ) :i 
[2 String doubleQuotel = [ 

■3 String doubleQuote2 = "\\u0022"; // "\u0022" doesn't work since """ doesn't work. 1 

l_i 



International language support 

The language distinguishes between bytes and characters. Characters are stored internally using UCS-2, although as of J2SE 5.0, the language also Supports using UTF-16 and its 
Surrogates. Java program source may therefore contain any Unicode character. 

The following is thus perfectly valid Java code; it contains Chinese characters in the dass and variable names as well as in a string literal: 

Code listing 3.50: PpDÜtMW*java 


11 public dass DnHütitW { 

1 2 private String = "Op®tÖW"; 

■3 } 

1 __ 


References 

1. "3.1 Unicode", The Java™ Fanguage Specification [1] (http://download.oracle.com/otn-pub/jcp/jls-7-mr3-fullv-oth-JSpec/JFS-JavaSE7-Full.pdf), Java SE 7 Edition, pp. 
15-16. 


Comments 


A comment allows to insert text that will not be compiled nor interpreted. It can appear anywhere in the source code where whitespaces are allowed. 
It is useful for explaining what the source code does by: 

■ explaining the adopted technical choice: why this given algorithm and not another, why calling this given method... 

■ explaining what should be done in the next Steps (the TODO list): improvement, issue to fix... 

■ giving the required explanation to understand the code and be able to update it yourself later or by other developers. 

It can also be used to make the Compiler ignore a portion of code: temporary code for debugging, code under development... 


109 sur 134 


30/01/2016 20:09 



















Java Programming/Print Version - Wikibooks, openbooks for an open worldhttps://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


Syntax 

The comments in Java use the same syntax as in C++. 

An end-of-line comment Starts with two slashes and ends with the end of the line. This syntax can be used on a single line too. 


m 


Code section 3.105: Slash-slash comment. 


il // A comment to give an example 

\2 

■3 int n = 10; // 10 articles 


A comment on several lines is framed with ’/' + and + ’/’. 


m 


Code section 3.106: Slash-star comment in multiple lines. 


1 /* 

2 * This is a comment 

3 * on several lines. 

4 */ 

5 

6 /* This also works; slash-star comments may be on a single line. *, 
1 

8 /* 

9 Disable debugging code: 

10 

11 int a = 10; 

12 while (a — > 0) System.out.println("DEBUG: tab["+a+"]=" + tab[a]); 

13 */ 


By convention, subsequent lines of slash-star comments begin with a star aligned under the star in the open comment sequence, but this is not required. Never nest a slash-star 
comment in another slash-star comment. If you accidentally nest such comments, you will probably get a syntax error from the Compiler soon after the first star-slash sequence. 


A 


Code section 3.107: Nested slash-star comment. 


1 /* This comment appears to contain /* a nested comment. 

2 * The comment ends after the first star-slash and 

3 * everything after the star-slash sequence is parsed 

4 * as non-comment source. 

5 */ 


If you need to have the sequence */ inside a comment you can use html numeric entities: *&#47; 
Slash-star comments may also be placed between any Java tokens, though not recommended: 


m 


Code section 3.108: Inline slash-star comment. 


■1 int i = /* maximum integer */ Integer. MAX_VALUE ; i 


However, comments are not parsed as comments when they occur in string literals. 


99 


Code section 3.109: String literal. 


■1 String text = "/* This is not a comment. */";i 


It results in a 33 character string. 
Test your knowledge 


Question 3.26: Consider the following code: 


m 


Question 3.26: Commented code. 


int a = 0; 

/ / a = a + 1 ; 
a = a + 1 ; 

/* 

a = a + 1 ; 

*/ 

a = a + 1 ; 

// /* 

a = a + 1 ; 

// */ 

a = a /*+ 1*/; 
a = a + 1; //a=a+l; 
System.out.printin("a=" + a); 


What is printed in the Standard output? 


Answer 


□ 


Output for Answer 3.26 


ia=4 


9V 


Answer 3.26: Commented code. 


1 int a = 0; 

2 // a = a + 1; 

a = a + 1 ; 
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3 4/* 

5 a = a + 1; 

6 */ 

7 a = a + 1; 

8 // /* 

9 a = a + 1; 

10 // */ 

11 a = a /* + 1*/; 

12 a = a + 1; // a = a + 1; 

13 System. out . println (" a= " + a); 



The highlighted lines are Code lines but line 11 does nothing and only the first part of line 12 is code. 


Comments and Unicode 


Be aware that Java still interprets Unicode sequences within comments. For example, the Unicode sequence \u002a\u002f (whose codepoints correspond to */) is processed early 
in the Java compiler's lexical scanning of the source file, even before comments are processed, so this is a valid star-slash comment in Java: 


m 


Code section 3.110: Unicode sequence interruption. 

;-1 

[l /* This is a comment. \u002a\u002f i 

■2 String Statement = "This is not a comment."; , 


and is lexically equivalent to 


m 


Code section 3.111: Unicode sequence interruption effect. 

;- 1 

,1 /* This is a comment . */ i 

■2 String Statement = "This is not a comment."; j 


(The ' * ' character is Unicode 0 02a and the ' / ' character is Unicode 0 02F.) 
Similar caveats apply to newline characters in slash-slash comments. 


For example: 


A 


Code section 3.112: New line. 


■1 // This is a single line comment \u000a This is code i 


That is because \u 0 0 0 a is Unicode for a new line, making the Compiler think that you have added a new line when you haven't. 


Javadoc comments 


Javadoc comments are a special case of slash-star comments. 



Code section 3.113: Javadoc comment. 


i 


Ii /** 

[2 * Comments which Start with slash-star-star are Javadoc comments. 
■3 * These are used to extract documentation from the Java source. 

[4 * More on javadoc will be covered later. 

[5 */ 

I_ 


Coding conventions 

The Java code conventions are defined by Oracle in the coding conventions (http://www.oracle.com/technetwork/java/codeconv-138413.html) document. In short, these 
conventions ask the user to use camel case when defining classes, methods, or variables. Classes Start with a Capital letter and should be nouns, like caiendarDiaiogview. For 
methods, the names should be verbs in imperative form, like getßrakeSystemType, and should Start with a lowercase letter. 

It is important to get used to and follow coding conventions, so that code written by multiple programmers will appear the same. Projects may re-define the Standard code 
conventions to better fit their needs. Examples include a list of allowed abbreviations, as these can often make the code difficult to understand for other designers. Documentation 
should always acompany code,. 

One example from the coding conventions is how to define a constant. Constants should be written with Capital letters in Java, where the words are separated by an underscore ('_') 
character. In the Java coding conventions, a constant isastatic final field in a dass. 

The reason for this diversion is that Java is not 100% object-oriented and discerns between "simple" and "complex" types. These will be handled in detail in the following sections. 
An example for a simple type is the byte type. An example for a complex type is a dass. A subset of the complex types are classes that cannot be modified after creation, like a 
string, which is a concatenation of characters. 

For instance, consider the following "constants": 

1-1 

1 1 public dass MotorVehicle { i 

, 2 /** Number of motors */ , 

1 3 private static final int MOTORS =1; 1 

! 4 | 

1 5 /** Name of a motor */ 1 

i 6 private static final String M0T0R_NAME = "Mercedes V8" ; i 

! 7 ' 
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i 8 /** The motor object */ i 

! 9 private static final Motor THE_MOTOR = new MercedesMotor(); [ 

[10 1 

111 /** I 

'12 * Constructor 1 

■ 13 V I 

[l4 public VehicleMotor () { [ 

■15 MOTORS = 2; // Gives a syntax error as MOTORS has already been assigned a value. 1 

il6 THE_MOTOR = new ToshibaMotor(); // Gives a syntax error as THE_MOTOR has already been assigned a value. i 

[17 MOTOR_NAME. toLowercase (); // Does not give a syntax error, because it returns a new String rather than editing the MOTOR_NAME variable. [ 

■18 THE_MOTOR. fi1lFuel (20.5); // Does not give a syntax error, as it changes a variable in the motor object, not the variable itself. i 

Jl9 } I 

■2 0 } ' 

I_i 


Classes and Objects 

Classes and Objects 

An object-oriented program is built from objects. A dass is a "template" that is used to create objects. The dass defines the values the object can contain and the operations that can 
be performed on the object. 

After Compilation, a dass is stored on the file System in a '(dass-name).class' file. 

The dass is loaded into memory when we are about to create the first object from that dass, or when we call one of its static functions. 

Düring dass loading all the dass static variables are initialized. Also operations defined in a static { ... } block are executed. Once a dass is loaded it stays in memory, and the 
dass static variables won't be initialized again. 

After the dass is loaded into memory, objects can be created from that dass. When an object is created, its member variables are initialized, but the dass static variables are not. 
When there are no more references to an object, the garbage collector will destroy the object and free its memory, so that the memory can be reused to hold new objects. 


Defining Classes 

Fundamentals 


Every dass in Java can be composed of the following elements: 

■ fields or member variables or instance variables — Fields are variables that hold data specific to each object. For example, an employee might have an ID number. There is 
one field for each object of a dass. 

■ member methods or instance variables — Member methods perform operations on an object. For example, an employee might have a method to issue his paycheck or to 
access his name. 

■ static fields — Static fields are common to any object of the same dass. For example, a static field within the Employee dass could keep track of the last ID number issued. 
Only one static field exists for one dass. 

■ static methods — Static methods are methods that do not affect a specific object. 

■ inner classes — Sometimes it is useful to contain a dass within another one if it is useless outside of the dass or should not be accessed outside the dass. 

■ Constructors — A special method that generates a new object. 

■ Parameterized types — Since 1.5, parameterized types can be assigned to a dass during definition. The parameterized types will be substituted with the types specified at 
the class’s instantiation. It is done by the Compiler. It is similar to the C language macro '#define' Statement, where a preprocessor evaluates the macros. 



Code listing 4.1: 


Employee.java 


, 1 public dass Employee { 

// 

I 2 


// 

I 3 


// 

[ 4 



I 5 

private static int nextID; 

// 

I 6 


// 

[ 7 



I 8 

private int mylD; 

// 

I 9 

private String myName; 

// 

Il 0 


// 

In 



Il 2 

public Employee (String name) { 

// 

Il 3 


// 

Il 4 

myName = name; 


Il 5 

mylD = nextID; 

// 

Il 6 

nextID++; 

// 

Il 7 

} 


Il 8 



Il 9 

public String getName () { 

// 

12 0 


// 

121 

return myName; 

// 

I 22 

} 


I 2 3 



I 2 4 

public int getID() { 

// 

12 5 



I 2 6 

return mylD; 


12 7 

} 


I 2 8 



12 9 

public static int getNextID() { 

// 

13 0 


// 

hl 

return nextID; 


I 32 

} 


133 } 




L 


-, 

This defines the Employee dass. 1 

The public modifier indicates that 1 

it can be accessed by any other dass 1 

Define a static field. Only one copy of this will exist, 1 

no matter how many Employees are created. 1 

Define fields that will be stored 1 

for each Employee. The private modifier indicates that 1 

only code inside the Employee dass can access it. 1 

This is a constructor. You can pass a name to the constructor 1 

and it will give you a newly created Employee object. 1 

Automatically assign an ID to the object 1 

Increment the ID counter 1 

This is a member method that returns the 1 

Employee object 's name. 1 

Note how it can access the private field myName. 1 

This is another member method. 1 


This is a static method that returns the next ID 
that will be assigned if another Employee is created. 


The following Java code would produce this output: 
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Code listing 4.2: EmployeeList.java 

;-1 

i 1 public dass EmployeeList { 1 

i 2 public static void main (String [] args) { 1 

! 3 1 

i 4 System. out . println (Employee. getNextID ()); 1 

! 5 1 

i 6 Employee a = new Employee (" John Doe") ; 1 

i 7 Employee b = new Employee (" Jane Smith"); 1 

i 8 Employee c = new Employee (" Sally Brown"); 1 

! 9 | 

ilO System. out . println (Employee. getNextID ()) ; 1 

■11 1 

■12 System. out . println (a. getID () + " + a. getName () ) ; 1 

■13 System. out . println (b . getID () + " + b . getName ()); 1 

■14 System. out . println (c. getID () + " + c. getName ()); 1 

•15 } ; 

■16 } 1 



Console for Code listing 4.2 


i-1 

!o ■ 

i3 ' 

■0 : John Doe 1 

■ 1 : Jane Smith 1 

■2 : Sally Brown 1 

L_ 1 


Constructors 


A constructor is called to initialize an object immediately after the object has been allocated: 


Code listing 4.3: Cheese.java 


i-1 

■1 public dass Cheese { 1 

i2 // This is a constructor 1 

■3 public Cheese () { 1 

i4 System, out .printin ( "Construct an instance" 1 

■5 } ; 

!ö } ; 

L_! 


Typically, a constructor is invoked using the new keyword: 

Code section 4.1: A constructor call. 

■-1 

|1 Cheese cheese = new Cheese () ; ■ 

l_i 



The constructor syntax is close to the method syntax. However, the constructor has the same name as the name of the dass (with the same case) and the constructor has no return 
type. The second point is the most important difference as a method can also have the same name as the dass, which is not recommended: 


Code listing 4.4: Cheese.java 

i-1 

■1 public dass Cheese { 1 

i2 // This is a method with the same name as the dass 1 

■3 public void Cheese () { 1 

i4 System. out . printin ( "A method execution. ") ; 1 

■5 } ; 

} ; 

i_! 


The returned object is always a valid, meaningful object, as opposed to relying on a separate initialization method. A constructor cannot be abstract, final, native, static, 
strictfp nor synchronized. However, a constructor, like methods, can be overloaded and take parameters. 


Code listing 4.5: Cheese.java 


1 public dass Cheese { 

2 // This is a constructor 

3 public Cheese () { 

4 doStuff(); 

5 } 

6 

7 // This is another constructor 

8 public Cheese (int weight) { 

9 doStuff(); 

10 } 

11 

12 // This is yet another constructor 

13 public Cheese (String type, int weight 

14 doStuff () ; 

15 } 

16 } 


By convention, a constructor that accepts an object of its own type as a parameter and copies the data members is called a copy constructor. One interesting feature of constructors 
is that if and only if you do not specify a constructor in your dass, the Compiler will create one for you. This default constructor, if written out would look like: 


Code listing 4.6: 


Cheese.java 


i-1 

■1 public dass Cheese { 1 

■2 public Cheese () { 1 

■3 super () ; 1 

■4 } ; 

■5 } ; 

L_! 


The super () command calls the constructor of the superclass. If there is no explicit call to super (...) or this (...), then the default superclass constructor super (); is called 
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before the body of the constructor is executed. That said, there are instances where you need to add in the call manually. For example, if you write even one constructor, no matter 
what parameters it takes, the Compiler will not add a default constructor. The code listing 4.8 results in a runtime error: 



Code listing 4.7: 


Cheese.java 


i-1 

11 public dass Cheese { 1 

12 public Cheese (int weight, String type) {' 

13 doStuf f () ; 1 

■4 } ; 

Is } ; 

i_! 



Code listing 4.8: Mouse.java 


11 public dass Mouse { 

12 public void eatCheese () { 

13 Cheese c = new Cheese () 

■4 } 

■5 } 

L_ 


T 


Oops, compile time erro 


This is something to keep in mind when extending existing classes. Either make a default constructor, or make sure every dass that inherits your dass uses the correct constructor. 

Initializers 


Initializers are blocks of code that are executed at the same time as initializers for fields. 

Static initializers 


Static initializers are blocks of code that are executed at the same time as initializers for static fields. Static field initializers and static initializers are executed in the Order declared. 
The static initialization is executed after the dass is loaded. 



Code section 4.2: Static initializer. 


n 


il static int count = 20; i 
[2 static int [ ] squares; J 
■3 static { // a static initializer ■ 
i4 squares = new int [count]; 1 
[5 for (int i = 0; i < count; i + + ) 1 
16 squares [i] = i * i; 1 
|7 } ; 
|8 static int x = squares [5]; // x is assigned the value 25' 
1 _ 1 


Instance initializers 


Instance initializers are blocks of code that are executed at the same time as initializers for instance (non-static) fields. Instance field initializers and instance initializers are 
executed in the order declared. Both instance initializers and instance field initializers are executed during the invocation of a constructor. The initializers are executed immediately 
after the superclass constructor and before the body of the constructor. 


Inheritance 


The inheritance is one of the most powerful mechanism of the Object Oriented Programming. It allows the reuse of the members of a dass (called the superclass or the mother 
class) in another dass (called subclass, child dass or the derived dass) that inherits from it. This way, classes can be built by successive inheritance. 

In Java, this mechanism is enabled by the extends keyword. Example: 



Code listing 4.9: 


Vehicle.java 


i-T 

11 public class Vehicle { 1 

12 public int speed; 1 

13 public int numberOfSeats; 1 

■4 } ; 

L_! 



Code listing 4.10: 


Car.java 


i-1 

11 public class Car extends Vehicle 1 

12 public Car () { 1 

13 this. speed = 90; 1 

14 this . numberOf Seat s = 5; 1 

Is } ; 

■6 } ; 

i_! 


In the Code listing 4.10, the class Car inherits from vehicle, which means that the attributes speed and numberOf Seat s are present in the class Car, whereas they are defined in 
the class vehicle. Also, the constructor defined in the class Car allows to initialize those attributes. In Java, the inheritance mechanism allows to define a class hierarchy with all 
the classes. Without explicit inheritance, a class implicitly inherits from the Object class. This Object class is the root of the class hierarchy. 

Some classes can't be inherited. Those classes are defined with the final keyword. For instance, the integer class can’t have subclasses. It is called a final class. 

The Object class 

At the instantiating, the child class receives the features inherited from its superclass, which also has received the features inherited from its own superclass and so on to the Object 
class. This mechanism allows to define reusable global classes, whose user details the behavior in the derived more specific classes. 
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In Java, a dass can only inherit from one dass. Java does not allow you to create a subclass from two classes, as that would require creating complicated rules to disambiguate fields 
and methods inherited from multiple superclasses. If there is a need for Java to inherit from multiple sources, the best Option is through interfaces, described in the next chapter. 

The super keyword 

The super keyword allows access to the members of the superclass of a dass, as you can use this to access the members of the current dass. Example: 

Code listing 4.11: Plane.java 


1 public dass Plane extends Vehicle { 

2 public Plane () { 

3 super (); 

4 } 

5 } 


In this example, the constructor of the Plane dass calls the constructor of its superclass vehicle. You can only use super to access the members of the superclass inside the child 
dass. If you use it from another dass, it accesses the superclass of the other dass. This keyword also allows you to explicitly access the members of the superclass, for instance, in 
the case where there is a method with the same name in your dass (overriding,...). Example : 

Code listing 4.12: Vehicle.java 


il public dass Vehicle { 

'i2 // . . . 

13 public void run() throws Exception 

14 position += speed; 

■5 } 

■6 } 


Code listing 4.13: Plane.java 


1 public dass Plane extends Vehicle { 

2 // . . . 

3 public void run ( ) throws Exception { 

4 if (0 < height) { 

5 throw new Exception ("A plane can't run in flight."); 

6 } eise { 

7 super . run ( ) ; 

8 } 

9 } 

10 } 


Test your knowledge 

Question 4.1: Consider the following classes. 



Question 4.1: Classl.java 



!i 

public dass Classl { 

1 



i2 

public static final int CONSTANT_OF_CLASS_l = 9; 



i3 

public int myAttributeOfClassl = 40; 




i4 

public void myMethodOfClassl ( int i) { 




i5 

} 




16 

} 




L _ 





Question 4.1: Class2.java 



!i 

public dass Class2 extends Classl { 



i2 

public int myAttributeOfClass2 = 10; 



i3 

public void myMethodOfClass2 ( int i) { 



i4 

} 



i5 

1 . 

} 



Question 4.1: Class3.java 



!i 

public dass Class3 { 

1 



i2 

public static final int CONSTANT_OF_CLASS_3 = 9; 



i3 

public void myMethodOfClass3 ( int i) { 




i4 

} 




■5 

} 




L _ 





Question 4.1: Questioni.java 



!i 

public dass Questioni extends Class2 { 



i2 

public static final int CONSTANT = 2; 



i3 

public int myAttribute = 20; 



h 

public void myMethod(int i) { 



i5 

} 



1 . 

} 


List all the attributes and methods that can be accessed in the dass Questioni. 

Answer 


■ CONSTANT_OF_CLASS_l 


115 sur 134 


30/01/2016 20:09 





























Java Programming/Print Version - Wikibooks, openbooks for an open worldhttps://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


■ myAttributeOfClassl 

■ myMethodOfClass 1 (int) 

■ myAttributeOfClass 2 

■ myMethodOfClass 2 (int) 

■ CONSTANT 

■ myAttribute 

■ myMethod(int) 

Questioni inherits from ciassi and ciass 2 but not from ciass 3 . 


See also the Object Oriented Programming book about the inheritance concept. 


Interfaces 


An interface is an abstraction of dass with no implementation details. For example, java. lang. comparabie is a Standard interface in Java. You cannot instantiate an interface. An 
interface is not a dass but it is written the same way. The first difference is that you do not use the dass keyword but the interface keyword to define it. Then, there are fields 
and methods you cannot define here: 

■ A field is always a constant: it is always public, static and final, even if you do not mention it. 

■ A method must be public and abstract, but it is not required to write the public and abstract keywords. 

■ Constructors are forbidden. 

An interface represents a contract : 

Code listing 4.14: Simplelnterface.java 


11 public interface Simplelnterface { 

12 public static final int CONSTANT1 = 1; 

13 int methodl (String parameter); 

■4 } 

L__ 


You can see that the methodl () method is abstract (unimplemented). To use an interface, you have to define a dass that implements it, using the impiements keyword: 


Code listing 4.15: ClassWithlnterface.java 

i-1 

11 public dass ClassWithlnterface implements Simplelnterface 1 

12 int methodl (St ring parameter) { 1 

13 return 0; 1 

■4 } ; 

■5 } ; 

L_ 1 


A dass can implement several interface, separated by a comma. Java interfaces behave much like the concept of the Objective-C protocol. It is recommended to name an interface 
<verb> abie, to mean the type of action this interface would enable on a dass. However, it is not recommended to Start the name of an interface by i as in C++. It is useless. Your 
IDE will help you instead. 

Interest 

If you have objects from different classes that do not have common superclasses, you can't call a same method on them, even if the two classes implement a method with the same 
signature. 

Code listing 4.16: OneClass.java 

i-1 

11 public dass OneClass { 1 

12 public int methodl (St ring parameter) 1 

13 return 1; 1 

■4 } 1 

■5 } ; 


Code listing 4.17: AnotherClass.java 

i-1 

11 public dass AnotherClass { 

12 public int methodl (String parameter) { 

13 return 2; 

■4 } 

■5 } 


A Code section 4.16: Impossible call. 


i-1 

il public static void main (String [ ] args) {i 

[2 doAction (new OneClass () ) ; j 

■3 doAction (new AnotherClass ()) ; 1 

i4 } ! 

[5 I 

16 public void doAction (Object anObject) { i 

[7 anObject .methodl ( "Hello!") ; [ 

| 8 } 1 

L_I 


The solution is to write an interface that defines the method that should be implemented in the two classes as the simplelnterface in the Code listing 4.14 and then the both dass 
implement the interface as in the Code listing 4.15. 
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Code section 4.17: Interface use. 


i 


■1 public static void main (String[] args) { 

[2 doAction (new ClassWithlnterface()); 

■3 doAction (new AnotherClassWithlnterface() ) ; 

h } 

[5 

16 public void doAction (Simplelnterface anObject) { 
[7 anObject .methodl ( "Hello ! " ) ; 

| 8 } 


You can also have this interest using a common super dass but a dass can only inherit from one super dass whereas it can implement several interfaces. Java does not support full 
orthogonal multiple inheritance. Java does not allow you to create a subclass from two classes. Multiple inheritance in C++ has complicated rules to disambiguate fields and 
methods inherited from multiple superclasses and types inherited multiple times. By separating interface from implementation, interfaces offer much of the benefit of multiple 
inheritance with less complexity and ambiguity. The price of no multiple inheritance is some code redundancy; since interfaces only define the signature of a dass but cannot 
contain any implementation, every dass inheriting an interface must provide the implementation of the defined methods, unlike in pure multiple inheritance, where the 
implementation is also inherited. The major benefit of that is that all Java objects can have a common ancestor. That dass is called Object. When overriding methods defined in 
interfaces there are several rules to be followed: 

■ Checked exceptions should not be declared on implementation methods other than the ones declared by the interface method or subclasses of those declared by the interface 
method. 

■ The signature of the interface method and the same return type or subtype should be maintained when implementing the methods. 

■ All the methods of the interface need to be defined in the dass, unless the dass that implements the interface is abstract. 


Extending interfaces 


An interface can extend several interfaces, similar to the way that a dass can extend another dass, using the 
extends keyword: 


Code listing 4.18: InterfaceA.java 

i-1 

11 public interface InterfaceA { 1 

12 public void methodA(); 1 

■3 } 


Code listing 4.19: InterfaceB.java 

i-1 

11 public interface InterfaceB { 1 

12 public void methodB(); 1 

■3 } 


Code listing 4.20: InterfaceAB.java 

i-1 

11 public interface InterfaceAB extends InterfaceA, InterfaceB 1 

12 public void otherMethod () ; 1 

■3 } 


This way, a dass implementing the InterfaceAB interface has to implement the methodA (), the methodB () and 
the otherMethod () methods: 

Code listing 4.21: ClassAB.java 


1 public dass ClassAB implements InterfaceA 

2 public void methodA () { 

3 System. out .printin ( "A" ); 

4 } 

5 

6 public void methodB () { 

7 System. out . printin ( "B" ); 

8 } 

9 


|10 

public vo 

id otherMethod () { 

In 

System. 

out . println ( " f 00 " ) ; 

Il 2 

} 


Il 3 



Il 4 

public static void main (String[ ] args) 

Il 5 

ClassAB 

classAb = new ClassAB(); 

Il 6 

classAb 

. methodA (); 

il 7 

classAb 

. methodB (); 

Il 8 

classAb 

. otherMethod (); 

Il 9 

} 


12 0 

} 



I 



Doing SO, a ClassAB Object can be casted into InterfaceA, InterfaceB and InterfaceAB. 


Test your knowledge 

Question 4.2: Consider the following interfaces. 

Question 4.2: Walkable.java 


1 public interface Walkable { 

2 void walk (); 

3 } 
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Question 4.2: Dumpable.java 

i-1 

11 public Interface Jumpable { 1 

12 void jump () ; 1 

■3 } 


Question 4.2: Swimable.java 

i-1 

11 public interface Swimable { 1 

12 void swim () ; 1 

■3 } 


Question 4.2: Movable.java 

i-1 

il public interface Movable extends Walkable, Jumpable {■ 
>2 } 


List all the methods that an implementing dass of Movable should implement. 


Answer 


walk () 
jump() 


Answer 4.2: Person.java 


- i 


11 public dass Person implements Movable { 

1 2 public void walk() { 

13 System. out . printin ( "Do something."); 

M } 

15 

16 public void jump() { 

17 System.out. println (" Do something. " ); 


} 


■9 } 


Question 4.3: Consider the following classes and the following code. 

Question 4.3: ConsoleLogger.java 

;-l 

11 import java . util. Date; 1 

12 ' 

13 public dass ConsoleLogger { 1 

14 public void printLog (String log) { 1 

15 System. out . printin (new Date () + ": " + log); 1 

■6 } ; 

\i } ; 

L_ 1 

Question 4.3: FileLogger.java 

\ - n 

i 1 import java.io.File; 1 

i 1 

i 2 import java.io.FileOutputStream; 1 

i 8 

. 3 ' 

i 8 

i 4 public dass FileLogger { 1 

i * 

i 5 public void printLog (String log) { 1 

! 6 try { J 

i 7 File file = new File (" log . txt ") ; 1 

i 1 

i 8 FileOutputStream stream = new FileOutputStream(file); 1 

i 9 byte [] loglnBytes = (new Date() + ": " + log) . getBytes (); 1 

!l0 1 

i 1 

il 1 stream. write (loglnBytes) ; 1 

i 1 

il 2 1 

i 1 

il3 stream. flush () ; 1 

i 1 

il 4 stream. close () ; 1 

i 1 

■15 } catch (Exception e) { 1 

i 1 

il 6 e. pr intStackTrace () ; 1 

Ii 7 } ; 

il 8 } I 

il 9 } 1 

i 1 

L_ I 

Question 4.3: Common code. 

- -1 

[l Object [] loggerArray = new Object [2]; i 

■2 loggerArray [ 0 ] = new ConsoleLogger () ; , 
i3 loggerArray [ 1 ] = new FileLogger () ; ■ 

J4 | 

i5 for (Object logger : loggerArray) { 1 

[ö // logger. printLog ( "Check point."); i 

[ 7 } : 

L_! 



Change the implementation of the code in Order to be able to uncomment the commented line without compile error. 


Answer 

You have to create an interface that defines the method printLog (String) and makes ConsoleLogger and FileLogger implement it: 
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Answer 4.3: Logger.java 

i-1 

11 public Interface Logger { ' 

12 void pr intLog (String log); 1 
■3 } 


Answer 4.3: ConsoleLogger.java 

i-1 

11 import java . util. Date; 1 

12 i 

13 public dass ConsoleLogger Implements Logger { 1 

14 public void printLog ( String log) { 1 

15 System . out . printin (new Date () + ": " + log); 1 

■6 } ; 

\i } ; 

L_! 

Answer 4.3: FileLogger.java 

;-n 

i 1 import java.io.File; 1 

i 2 import java.io.FileOutputStream; 1 

! 3 1 

i 4 public dass FileLogger Implements Logger { 1 

i 5 public void printLog (String log) { 1 

i 6 try { 1 

i7 File file = new File("log.txt"); 1 

i 8 FileOutputStream stream = new FileOutputStream(file); 1 

i 9 byte [] loglnBytes = (new Date() + " + log) . getBytes (); 1 

!l0 | 

il1 stream. write (loglnBytes); s 

!l 2 1 

il3 stream. f lush () ; 1 

il 4 stream. close () ; 1 

il5 } catch (Exception e) { 8 

il 6 e. printStackTrace () ; 1 

>i 7 } ; 

■i8 } ; 

■i 9 } ; 

L_I 


Now your code has to cast the objects to the Logger type and then you can uncomment the code. 

Answer 4.3: Common code. 

;-1 

,1 Logger [ ] loggerArray = new Logger [2] ;i 
■2 loggerArray [ 0 ] = new ConsoleLogger ();, 

i3 loggerArray [ 1 ] = new FileLogger () ; 1 

[4 i 

i5 for (Logger logger : loggerArray) { 1 

,6 logger. printLog (" Check point."); i 

[7 i ; 

i_! 



Overloading Methods and Constructors 


Method overloading 

In a dass, there can be several methods with the same name. However they must have a different signature. The signature of a method is comprised of its name, its parameter types 
and the Order of its parameter. The signature of a method is not comprised of its return type nor its visibility nor its exceptions it may throw. The practice of defining two or more 
methods within the same dass that shares the same names but different parameters is called overloading methods. 

Methods with the same name in a dass are called overloaded methods. Overloading methods offers no specific benefit to the JVM but it is useful to the programmer to have several 
methods do the same things but with different parameters. For example, we may have the Operation runAroundThe represented as two methods with the same name, but different 
input parameter types: 

Code section 4.22: Method overloading. 

;- 1 

[l public void runAroundThe (Building block) {■ 

j 2 : 

.3 } 

! 4 ! 

i5 public void runAroundThe (Park park) { 8 

[ö . . . I 

: 7 } : 

i_ 1 


One type can be the subclass of the other: 


Code listing 4.11: ClassName.java 

i-1 

i 1 public dass ClassName { 1 

! 2 ' 

i 3 public static void sayClassName (Object aObject) {■ 

i 4 System. out . printin ( "Ob ject ") ; 1 

! 5 } ; 

I 6 1 

i 7 public static void sayClassName (String aString) {■ 

i 8 System . out . println (" String ") ; 1 

! 9 } ■ 



Console for Code listing 4.11 


J-1 

iString 1 

«Object 1 

L_! 
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!io 

111 public static void main (String[] args) { 

112 String aString = new String (); 

113 sayClassName (aString) ; 
il 4 

il5 Object aObject = new String (); 

il 6 sayClassName(aObject); 

■ 17 } 

Il 8 } 

L_ 


Although both methods would be fit to call the method with the string parameter, it is the method with the nearest type that will be called instead. To be more accurate, it will call 
the method whose parameter type is a subclass of the parameter type of the other method. So, aObject will output Object. Beware! The parameter type is defined by the declared 
type of an object, not its instantiated type! 

The following two method definitions are valid 



Code section 4.23: Method overloading with the type order. 
;-1 


,1 public void loglt (String param. Error err) { 

■2 

i3 } 

[4 

i5 public void loglt (Error err, String param) { 

|6 

| 7 } 

l_ 


because the type order is different. If both input parameters were type String, that would be a problem since the Compiler would not be able to distinguish between the two: 

A Code section 4.24: Bad method overloading. 

;-1 

,1 public void loglt (String param, String err) {i 

v ... : 

.3 } 

1 4 ! 

15 public void loglt (String err, String param) {' 

[6 . . . i 

: 7 } : 

i_! 


The Compiler would give an error for the following method definitions as well: 

A Code section 4.25: Another bad method overloading. 

[l public void loglt (String param) { i 

■2 | 

|3 } 

■4 I 

i5 public String loglt (String param) { 1 

[6 String retValue; i 

il I 

,8 return retValue; ■ 

'9 } ! 


Note, the return type is not part of the unique signature. Why not? The reason is that a method can be called without assigning its return value to a variable. This feature came from 
C and C++. So for the call: 

A Code section 4.26: Ambiguous method call. 



■1 loglt (msg) ; 


the Compiler would not know which method to call. It is also the case for the thrown exceptions. 
Test your knowledge 

Question 4.6: Which methods of the Question 6 dass will cause compile errors? 

Question6.java 


1 public dass Question6 { 

2 

3 public void examplel () { 

4 } 

5 

6 public int examplel () { 

7 } 

8 

9 public void example2(int x) { 

10 } 

11 

12 public void example2(int y) { 

13 } 

14 

15 private void example3() { 

16 } 

11 

18 public void example3() { 

19 } 

20 

21 public String example4(int x) { 

22 return null; 

23 } 

24 

25 public String example4() { 
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i2 6 return null; 

i2 7 } 

i2 8 } 

L__ 


Answer 

Question6.java 


1 public dass Question6 { 

2 

3 public void examplel () { 

4 } 

5 

6 public int examplel () { 

7 } 

8 

9 public void example2(int x) { 

10 } 

11 

12 public void example2(int y) { 

13 } 

14 

15 private void example3() { 

16 } 

17 

18 public void example3() { 

19 } 

20 

21 public String example4 (int x) { 

22 return null; 

23 } 

24 

25 public String example4() { 

26 return null; 

27 } 

28 } 


The examplel, exampie2 and exampie3 methods will cause compile errors. The examplel methods cannot co-exist because they have the same signature (remember, return 
type is not part of the signature). The exampie 2 methods cannot co-exist because the names of the parameters are not part of the signature. The exampie3 methods cannot 
co-exist because the visibility of the methods are not part of the signature. The exampie4 methods can co-exist, because they have different method signatures. 


Variable Argument 


Instead of overloading, you can use dynamic number of arguments. After the last parameter, you can pass optional unlimited parameters of the same type. These parameters are 
defined by adding a last parameter and adding . . . after its type. The dynamic arguments will be received as an array: 


m 


Code section 4.27: Variable argument. 


public void registrerPersonlnAgenda (String firstName, String lastName, Date. 
String[] person = {firstName, lastName}; 
lastPosition = lastPosition + 1; 
contactArray[lastPosition] = person; 


. meeting 


9 

10 

11 

12 

13 

14 

15 

16 


if (meeting. length > 0) { 

Date [] temporaryMeetings = registreredMeetings. length + meeting.length; 
for (i = 0; i < registreredMeetings.length; i++) { 

temporaryMeetings[i] = registreredMeetings[i]; 


} 


for (i = 0; i < meeting.length; i++) { 

temporaryMeetings[registreredMeetings. length + i] = meeting[i]; 


} 


registreredMeetings = temporaryMeetings; 


The above method can be called with a dynamic number of arguments, for example: 




Code section 4.27: Constructor calls. 


,1 registrerPersonlnAgenda( "John", "Doe"); 

■2 registrerPersonlnAgenda ( "Mark" , "Lee", new Date () , new DateO); 


This feature was not available before Java 1.5 . 


Constructor overloading 


The constructor can be overloaded. You can define more than one constructor with different parameters. For example: 


Code listing 4.12: Constructors. 


1 public dass MyClass { 


2 


3 private String memberField; 

4 

5 /** 

6 * MyClass Constructor, there is no input parameter 


V 


public MyClass () { 


10 } 
11 
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112 /** 

113 * MyClass Constructor, there is one input parameter 

il 4 */ 

il5 public MyClass (String paraml) { 

il 6 memberField = paraml; 

Il 7 

Il 8 } 

Il 9 } 


In the code listing 4.12, we defined two constructors, one with no input parameter, and one with one input parameter. You may ask which constructor will be called. Its depends 
how the object is created with the new keyword. See below: 



Code section 4.29: Constructor calls. 

i-1 

il // The constructor with no input parameter will be calledi 
[2 MyClass ob j 1 = new MyClass (); J 

■3 ' 

,4 // The constructor with one input param. will be called , 
■5 MyClass obj2 = new MyClass( " Init Value" ); 1 

l_ 1 


In the code section 4.29, we created two objects from the same dass, or we can also say that ob j l and ob j2 both have the same type. The difference between the two is that in the 
first one the memberField field is not initialized, in the second one that is initialized to " init value". A constructor may also be called from another constructor, see below: 

Code listing 4.13: Constructor pooling. 


1 public dass MyClass { 

2 

3 private String memberField; 

4 

5 /** 

6 * MyClass Constructor, there is no input parameter 

7 */ 

8 public MyClass () { 

9 MyClass( "Default Value") ; 

10 } 

11 

12 /** 

13 * MyClass Constructor, there is one input parameter 

14 */ 

15 public MyClass (String paraml) { 

16 memberField = paraml; 

17 

18 } 

19 } 


In the code listing 4.13, the constructor with no input parameter calls the other constructor with the default initial value. This call must be the first instruction of a constructor or eise 
a Compiler error will occur. The code gives an Option to the user, to create the object with the default value or create the object with a specified value. The first constructor could 
have been written using the this keyword as well: 

Code section 4.30: Another constructor pooling. 

i-1 

il public MyClass () { i 

[2 this ( "Default Value"); | 

! 3 } ! 

1_1 



Such a call reduces the code repetition. 


Method overriding 


To easily remember what can be done in method overriding, keep in mind that all you can do on an object of a dass outside this dass, you can do it also on an object of a subclass, 
only the behavior can change. A subclass should be covariant. 

Although a method signature has to be unique inside a dass, the same method signature can be defined in different classes. If we define a method that exists in the super dass then 
we override the super dass method. It is called method overriding. This is different from method overloading. Method overloading happens with methods with the same name 
different signature. Method overriding happens with same name, same signature between inherited classes. 

The return type can cause the same problem we saw above. When we override a super dass method the return type also must be the same. If that is not the same, the Compiler will 
give you an error. 

Beware! If a dass declares two public methods with the same name, and a subclass Overrides one of them, the subclass still inherits the other method. In this respect, the Java 
programming language differs from C++. 

Method overriding is related dynamic linking, or runtime binding. In Order for the Method Overriding to work, the method call that is going to be called can not be determined at 
Compilation time. It will be decided at runtime, and will be looked up in a table. 



Code section 4.31: Runtime binding. 


-, 

1 MyClass obj; i 

2 ! 

3 if (new java.util .Calendar () . get (java.util.Calendar.AM_PM) == java.util.Calendar.AM) { 1 

4 // Executed a morning i 

5 obj = new SubOfMyClass(); 1 

6 } eise { i 

7 // Executed an afternoon 

8 obj = new MyClass(); ■ 

9 } ! 

10 | 

11 obj .myMethod (); i 


In the code section 4.31, the expression at line 3 is true if it is executed a morning and false if it is executed an afternoon. Thus, the instance of obj will be a MyClass or a 
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subofMyciass depending on the execution time. So it is impossible to determine the method address at compile time. Because the ob j reference can point to object and all its sub 
object, and that will be known only at runtime, a table is kept with all the possible method addresses to be called. Do not confuse: 


^ Code section 4.32: Declared type and instantiated type. 


■1 ob j . myMethod (myParameter) ; 

l__ 


The implementation of this method is searched using the instantiated type of the called object (ob j) and the declared type of the parameter object (myParameter). 

Also another rule is that when you do an override, the visibility of the new method that overrides the super dass method can not be reduced. The visibility can be increased, 
however. So if the super dass method visibility is public, the override method can not be package, or private. An override method must throw the same exceptions as the super 
dass, or their subexceptions. 

super references to the parent dass (i.e. super. someMethod ()). It can be used in a subclass to access inherited methods that the subclass has overridden or inherited fields that the 
subclass has hidden. 

A common mistake to think that if we can override methods, we could also override member variables. This is not the case, as it is useless. You can redefine a variable that 
is private in the super dass as such a variable is not visible. 


Object Lifecycle 

Before a Java object can be created the dass byte code must be loaded from the file System (with . dass extension) to memory. This process of locating the byte code for a given 
dass name and Converting that code into a Java dass instance is known as dass loading. There is one dass created for each type of Java dass. 

All objects in Java programs are created on heap memory. An object is created based on its dass. You can consider a dass as a blueprint, template, or a description how to create an 
object. When an object is created, memory is allocated to hold the object properties. An object reference pointing to that memory location is also created. To use the object in the 
future, that object reference has to be stored as a local variable or as an object member variable. 

The Java Virtual Machine (JVM) keeps track of the usage of object references. If there are no more reference to the object, the object can not be used any more and becomes 
garbage. After a while the heap memory will be full of unused objects. The JVM collects those garbage objects and frees the memory they allocated, so the memory can be reused 
again when a new object is created. See below a simple example: 

Code section 4.30: Object creation. 

\ -! 

|i { ■ 

■2 // Create an object , 

i3 MyObject obj = new MyObject (); 1 

P i 

■5 // Use the object 1 

[6 ob j . printMyValues () ; i 

! 7 } : 

i_! 



The obj variable contains the object reference pointing to an object created from the MyObject dass. The obj object reference is in scope inside the { }. After the } the object 
becomes garbage. Object references can be passed in to methods and can be returned from methods. 


Creating object with the new keyword 

99% of new objects are created using the new keyword. 


Code listing 4.13: MyProgram.java 


;-n 

11 public dass MyProgram { 1 

12 ' 

13 public static void main (String[] args) { 1 

14 // Create an 'MyObject' for the first time the application started} 

15 MyObject obj = new MyObject (); 1 

■6 } ; 

\i } ; 

L_! 


When an object from the MyObject dass is created for the first time, the JVM searches the file System for the definition of the dass, that is the Java byte code. The file has the 
extension of * . dass. The CLASSPATH environment variable contains locations where Java classes are stored. The JVM is lookingfor the MyObject .dass file. Depending on 
which package the dass belongs to, the package name will be translated to a directory path. 

When the MyObject. dass file is found, the JVM's dass loader loads the dass in memory, and creates a java.lang.Class object. The JVM Stores the code in memory, allocates 
memory for the static variables, and executes any static initialize block. Memory is not allocated for the object member variables at this point, memory will be allocated for them 
when an instance of the dass, an object, is created. 

There is no limit on how many objects from the same dass can be created. Code and static variables are stored only once, no matter how many objects are created. Memory is 
allocated for the object member variables when the object is created. Thus, the size of an object is determined not by its code’s size but by the memory it needs for its member 
variables to be stored. 


Creating object by cloning an object 


Cloning is not automatically available to classes. There is some help though, as all Java objects inherit the protected object cione () method. This base method would allocate 
the memory and do the bit by bit copying of the object's States. 

You may ask why we need this cione method. Couldn’t I create a constructor and just passing in the same object, and do the copying variable by variable? Let’s see: 


Code listing 4.14: MyObject.java 


-- 1 

1 public dass MyObject { 1 


123 sur 134 


30/01/2016 20:09 




















Java Programming/Print Version - Wikibooks, openbooks for an open worldhttps://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


12 private int memberVar; 

13 ... 

14 MyOb ject (MyOb ject obj) { 

15 this . memberVar = obj. memberVar; 

16 

■7 } 

18 ... 

! 9 } 


You might think that accessing the private memberVar variable of obj would fail but as this is in the same dass this Code is legal. The clone () method copies the whole object's 
memory in one Operation. This is much faster than using the new keyword. Object creation with the new keyword is expensive, so if you need to create lots of objects with the same 
type, performance will be better if you create one object and clone new ones from it. See below a factory method that will return a new object using cloning. 



Code section 4.31: Object cloning. 


i 


1 HashTable cacheTemplate = new HashTable(); 

2 ... 

3 /** Clone Customer object for performance reason */ 

4 public Customer createCustomerObject () { 

5 // See if a template object exists in our cache 

6 Customer template = cacheTemplate. get ( "Customer") ; 

7 if (template == null) { 

8 // Create template 

9 template = new Customer(); 

10 cacheTemplate.put( "Customer" , template); 

11 } 

12 return template. clone (); 

13 } 



Now, let's see how to make the Customer object cloneable. 

1. First the Customer dass needs to implement the cloneable Interface. 

2. Override and make the clone () method public, as that is protected in the Object dass. 

3. Call the super. clone () method at the beginning of your clone method. 

4. Override the clone () method in all the subclasses of Customer. 

Code listing 4.15: Customer.java 


11 public dass Customer implements Cloneable { 

12 

13 public Object clone () throws CloneNotSupportedException { 

14 Object obj = super . clone (); 

15 

16 return obj; 

■7 } 

■8 } 

l_ 


In the code listing 4.15 we used cloning for speed up object creation. Another use of cloning could be to take a snapshot of an object that can change in time. Let's say we want to 
störe Customer objects in a Collection, but we want to disassociate them from the 'live' objects. So before adding the object, we clone them, so if the original object changes from 
that point forward, the added object won't. Also let's say that the Customer object has a reference to an Activity object that contains the customer activities. Now we are facing a 
problem, it is not enough to clone the Customer object, we also need to clone the referenced objects. The solution: 

1. Make the Activity dass also cloneable 

2. Make sure that if the Activity dass has other 'changeable' object references, those has to be cloned as well, as seen below 

3. Change the Customer dass clone () method as follows: 

Code listing 4.16: Customer.java 


1 public dass Customer implements Cloneable { 

2 Activity activity; 

3 

4 public Customer clone () throws CloneNotSupportedException { 

5 Customer clonedCustomer = (Customer) super . clone (); 

6 

7 // Clone the object referenced objects 

8 if (activity != null) { 

9 clonedCustomer. setActivity ((Activity) activity . clone () 

10 } 

11 return clonedCustomer; 

12 } 

13 } 


Note that only mutable objects needs to be cloned. References to unchangeable objects such as String be used in the cloned object without worry. 

Creating object receiving from a remote source 

When an object is sent through a network, the object needs to be recreated at the receiving host. 

Object Serialization 

The term Object Serialization refers to the act of Converting the object to a byte stream. The byte stream can be stored on the file System, or can be sent through a network. 
At the later time the object can be re-created from that stream of bytes. The only requirement is that the same dass has to be available at both times, when the object is 
serialized and also when the object is re-created. If that happens in different Servers, then the same dass must be available on both Servers. Same dass means that exactly the 
same Version of the dass must be available, otherwise the object won't be able to be re-created. This is a maintenance problem to those applications where java serialization is 
used to persist object or sent the object through the network. 

When a dass is modified, there could be a problem re-creating those objects that were serialized using an earlier Version of the dass. 

Java has built-in support for serialization, using the seriaiizabie interface; however, a dass must first implement the seriaiizabie interface. 

By default, a dass will have all of its fields serialized when converted into a data stream (with transient fields being skipped). If additional handling is required beyond the default 
of writing all fields, you need to provide an implementation for methods: 
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private void writeObject(java.io.ObjectOutputStream out) throws IOException; 

private void readObject(java.io.ObjectInputStream in) throws IOException, ClassNotFoundException; 
private void readObjectNoData() throws ObjectStreamException; 

If the object needs to write or provide a replacement object during serialization, it needs to implement the following two methods, with any access specifier: 

Object writeReplace() throws ObjectStreamException; 

Object readResolve() throws ObjectStreamException; 

Normally, a minor change to the dass can cause the serialization to fail. You can still allow the dass to be loaded by defining the serialization Version id: 

Code section 4.32: Serialization Version id. 

■- 1 

■1 private static final long serialVersionUID = 42L;i 



Destroying objects 

Unlike in many other object-oriented programming languages, Java performs automatic garbage collection — any unreferenced objects are automatically erased from memory — 
and prohibits the user from manually destroying objects. 

finalize() 

When an object is garbage-collected, the programmer may want to manually perform cleanup, such as closing any open input/output streams. To accomplish this, the finalize () 
method is used. Note that final ize () should never be manually called, except to call a super dass’ finalize method from a derived dass’ finalize method. Also, we can not rely on 
when the f inaiize () method will be called. If the java application exits before the object is garbage-collected, the finalize () method may never be called. 

Code section 4.33: Finalization. 


[l protected void finalize () throws Throwable { 

■2 try { 

i3 doCleanup(); // Perform some cleanup. If it falls for some reason, it is ignored. 

[4 } finally { 

■5 super . finalize (); // Call finalize on the parent object 

|6 } 

| 7 } 

l_ 



The garbage-collector thread runs in a lower priority than the other threads. If the application creates objects faster than the garbage-collector can claim back memory, the program 
can run out of memory. 

The finalize method is required only if there are resources beyond the direct control of the Java Virtual Machine that needs to be cleaned up. In particular, there is no need to 
explicitly dose an OutputStream, since the OutputStream will dose itself when it gets finalized. Instead, the finalize method is used to release either native or remote resources 
controlled by the dass. 

Class loading 

One of the main concerns of a developer writing hot re-deployable applications is to understand how dass loading works. Within the internals of the dass loading mechanism lies 
the answer to questions like: 

■ What happens if I pack a newer Version of an utility library with my application, while an older Version of the same library lingers somewhere in the server’s lib directory? 

■ How can I use two different versions of the same utility library, simultaneously, within the same instance of the application Server? 

■ What Version of an utility dass I am currently using? 

■ Why do I need to mess with all this dass loading stuff anyway? 


Scope 

Scope 

The scope of a dass, a variable or a method is its visibility and its accessibility. The visibility or accessibility means that you can use the item from a given place. 

Scope of method parameters 

A method parameter is visible inside of the entire method but not visible outside the method. 

Code listing 3.14: Scope.java 


1 public class Scope { 

2 

3 public void methodl(int i) { 

4 i = i++; 

5 method2(); 

6 int j = i * 2; 

7 } 

8 

9 public void method2 () { 

10 int k = 20; 

11 } 

12 

13 public static void main (String[] args) { 

14 methodl(10); 
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Il5 } 

il 6 } 


In code listing 3.14, i is visible within the entire methodi method but not in the method2 and the main methods. 

Scope of local variables 

A local variable is visible after its declaration until the end of the block in which the local variable has been created. 


m 


Code section 3.50: Local variables. 


1 { 

2 . 

3 

4 

5 

6 

7 

8 
9 

;io 
■11 
Il 2 

| 13 
il 4 

[l 5 . 

■16 } 

i 

l_ 


// myNumber is NOT visible 

// myNumber is NOT visible 
int myNumber; 

// myNumber is visible 


{ 


// myNumber is visible 
// myNumber is visible 


// myNumber is NOT visible 


Access modifiers 


You surely would have noticed by now, the words public, protected and private at the beginning of class's method declarations used in this book. These keywords are called the 
access modifiers in the Java language syntax, and they define the scope of a given item. 

For a dass 


■ If a dass has public visibility, the dass can be referenced by anywhere in the program. 

■ If a dass has package visibility, the dass can be referenced only in the package where the dass is defined. 

■ If a dass has private visibility, (it can happen only if the dass is defined nested in an other dass) the dass can be accessed only in the outer dass. 

For a variable 

■ If a variable is defined in a public dass and it has public visibility, the variable can be referenced anywhere in the application through the dass it is defined in. 

■ If a variable has protected visibility, the variable can be referenced only in the sub-classes and in the same package through the dass it is defined in. 

■ If a variable has package visibility, the variable can be referenced only in the same package through the dass it is defined in. 

■ If a variable has private visibility, the variable can be accessed only in the dass it is defined in. 

For a method 


■ If a method is defined in a public dass and it has public visibility, the method can be called anywhere in the application through the dass it is defined in. 

■ If a method has protected visibility, the method can be called only in the sub-classes and in the same package through the dass it is defined in. 

■ If a method has package visibility, the method can be called only in the same package through the dass it is defined in. 

■ If a method has private visibility, the method can be called only in the dass it is defined in. 

For an interface 


The interface methods and interfaces are always public. You do not need to specify the access modifier. It will default to public. For clarity it is considered a good practice to put 
the public keyword. 

The same way all member variables defined in the Interface by default will become static final once inherited in a dass. 

Summary 



Class 

Nested class 

Method, or Member variable 

Interface 

Interface method signature 

public 

visible from anywhere 

same as its class 

same as its class 

visible from anywhere 

visible from anywhere 

protected 

N/A 

its class and its subclass 

its class and its subclass, and from its package 

N/A 

N/A 

package 

only from its package 

only from its package 

only from its package 

N/A 

N/A 

private 

N/A 

only from its class 

only from its class 

N/A 

N/A 


The cases in bold are the default. 


Utility 

A general guideline for visibilities is to only make a member as visible as it needs to be. Don’t make a member public if it only needs to be private. 

Doing so, you can rewrite a dass and change all the private members without making Compilation errors, even you don't know all the classes that will use your dass as long as you 
do not change the signature of the public members. 


Field encapsulation 

Generally, it is best to make data private or protected. Access to the data is controlled by setter and getter methods. This lets the programmer control access to data, allowing 
him/her to check for and handle invalid data. 

PP Code section 3.51: Encapsulation. 

j-, 

[ 1 private String name; i 
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2 

3 /** 

4 * This is a getter method because it accesses data from the object. 

5 */ 

6 public String getName () { 

7 return name; 

8 } 

9 

10 /** 

11 * This is a setter method because it changes data in the object. 

12 V 

13 public boolean setName (String newName) { 

14 if (newName == null) { 

15 return false; 

16 } eise { 

17 name = newName; 

18 return true; 

19 } 

20 } 


In the code section 3.51, the setName () method will only change the value of name if the new name is not null. Because setName () is conditionally changing name, it is wise to 
return a boolean to let the program know if the change was successful. 


Test your knowledge 

Question 3.15: Consider the following dass. 

Question 3.15: Questionl5.java 


1 public dass Questionl5 { 

2 

3 public static final int QKQKQKQK_MULTIPLIER = 2; 

4 

5 public int ijijijijijijijijijAwfulName = 20; 

6 

7 private int unununununununununCrummyName = 10; 

8 

9 private void mememememememeUglyName ( int i) { 

10 i = i + + ; 

11 tltltltltltltltltlBadName(); 

12 int j = i * QKQKQKQK_MULTIPLIER; 

13 } 

14 

15 public void tltltltltltltltltlBadName () { 

16 int k = ijijijijijijijijijAwfulName; 

17 } 

18 

19 public static void main (String[] args) { 

20 mememememememeUglyName(unununununununununCrummyName); 

21 } 

22 } 


List the fields and methods of this dass that can be renamed without changing or even knowing the dient classes. 

Answer 

1. unununununununununCrummyName 

2. mememememememeUglyName() 

Every field or method that is public can be directly called by a dient dass so this dass would return a compile error if the field or the method has a new name. 


Nested Classes 


In Java you can define a dass inside an other dass. A dass can be nested inside another dass or inside a method. A dass that is not nested is called a top-level dass and a dass 
defining a nested dass is an outer dass. 

Inner classes 

Nesting a dass inside a dass 

When a dass is declared inside another dass, the nested dass' access modifier can be public, private, protected or package (def auit). 

Code listing 4.10: OuterClass.java 


11 public dass OuterClass { 

12 private String outerInstanceVar; 

13 

14 public dass InnerClass { 

15 public void printVars () { 

16 System. out . printin ( "Print Outer dass Instance Var.:" + outerlnstanceVar 

■7 } 

■8 } 

! 9 } 


The inner dass has access to the enclosing dass instance’s variables and methods, even private ones, as seen above. This makes it very different from the nested dass in C++, which 
are equivalent to the "static" inner classes, see below. 
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An inner object has a reference to the outer object. In other words, all inner objects are tied to the outer object. The inner object can only be created through a reference to the 
'outer' object. See below. 


m 


Code section 4.20: Outer dass call. 


■1 public void testinner () { 

',2 

[3 OuterClass outer = new OuterClass(); 

■4 OuterClass. InnerClass inner = outer. new InnerClass (); 

[5 

[6 } 


Note that inner objects, because they are tied to the outer object, cannot contain static variables or methods. 

When in a non-static method of the outer dass, you can directly use new InnerClass (), since the dass instance is implied to be this. 

You can directly access the reference to the outer object from within an inner dass with the syntax OuterClass . this; although this is usually unnecessary because you already 
have access to its fields and methods. 

Inner classes compile to separate ".dass" bytecode files, with the name of the enclosing dass, followed by a "$", followed by the name of the inner dass. So for example, the above 
inner dass would be compiled to a file named "OuterClass$InnerClass.class". 

Static inner classes 


An inner dass can be declared static. These classes are not bound to an instance of the outer defining dass. A static inner dass has no enclosing instance, and therefore cannot 
access instance variables and methods of the outer dass. You do not specify an instance when creating a static inner dass. This is equivalent to the inner classes in C++. 

Nesting a dass inside a method 

These inner classes, also called local classes , cannot have access modifiers, like local variables, since the dass is 'private' to the method. The inner dass can be only abstract or 

final. 


Code listing 4.11: OuterClass.java 

;- 1 

11 public dass OuterClass { 1 

12 public void method () { 1 

13 dass InnerClass { 1 

h ' 

!s } ; 

■6 } ; 

\i } ; 

i_ 1 


In addition to instance variables of the enclosing dass, local classes can also access local variables of the enclosing method, but only ones that are declared final. This is because 
the local dass instance might outlive the invocation of the method, and so needs its own copy of the variable. To avoid problems with having two different copies of a mutable 
variable with the same name in the same scope, it is required to be final, so it cannot be changed. 

Anonymous Classes 

In Java, a dass definition and its instantiation can be combined into a single Step. By doing that the dass does not require a name. Those classes are called anonymous classes. An 
anonymous dass can be defined and instantiated in contexts where a reference can be used, and it is a nested dass to an existing dass. Anonymous dass is a special case of a dass 
local to a method; hence they also can access final local variables of the enclosing method. 

Anonymous classes are most useful to create an instance of an interface or adapter dass without needing a brand new dass. 

Code listing 4.12: ActionListener.java 


1 public interface ActionListener { 

2 public void actionPerformed (); 

3 } 


Code section 4.21: Anonymous dass. 


[l ActionListener listener = new ActionListener() { 

■2 public void actionPerf ormed () { 

i3 // Implementation of the action event 

[4 

i5 return; 

|6 } 

! 7 }; 



In the above example the dass that implements the ActionListener is anonymous. The dass is defined where it is instantiated. 

The above code is harder to read than if the dass is explicitly defined, so why use it? If many implementations are needed for an interface, those classes are used only in one 
particular place, and it would be hard to come up with names for them, using an anonymous inner dass makes sense. 

The following example uses an anonymous inner dass to implement an action listener. 



Code listing 4.13: MyApp.java 


-1 

1 import java.awt.Button; 1 

2 import java.awt.event.ActionEvent ; 1 

3 import java.awt.event.ActionListener; ■ 

4 ' 

5 dass MyApp { 1 

6 Button aButton = new Button(); 1 

7 1 

8 MyApp() { | 

9 aButton. addActionListener (new ActionListener() { 1 
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i ■ 

110 public void actionPerf ormed (ActionEvent e) {■ 

111 System. out . printin ( "Hello There") ; i 

!l 2 } i 

Il 3 } i 

114 ); ■ 

115 } ' 

■16} J 


The following example does the same thing, but it names the dass that implements the action listener. 

Code listing 4.14: MyApp.java 

;-1 

i ■ 

i 1 Import java.awt.Button; 1 

i 1 

i 2 Import java.awt.event.ActionEvent; 1 

i 1 

i 3 import java.awt.event.ActionListener; 1 

i 1 

i 4 ' 

i 1 

i 5 dass MyApp { 1 

i 6 Button aButton = new Button(); 1 

i 1 

i 7 1 

i 1 

i 8 // Nested dass to implement the action listener 1 

i 9 dass MyActionListener implements ActionListener { 1 

i 1 

110 public void actionPerformed (ActionEvent e) { 1 

i 1 

111 System. out . printin ( "Hello There"); 1 

Il 2 } 1 

Il 3 } 1 

i 1 

il 4 MyApp ( ) { 1 

i 1 

il5 aButton. addActionListener (new MyActionListener()); 1 

Ii 6 } ; 

*17 } ; 


Using anonymous classes is especially preferable when you intend to use many different classes that each implement the same interface. 


Generics 

Java is a strongly typed language, so a field in a dass may be typed like this: 

Code listing 4.34: Repository.java 


1 public dass Repository { 

2 

3 public Integer item; 

4 

5 public Integer getltem() { 

6 return item; 

7 } 

8 

9 public void setltem (Integer newltem) { 

10 item = newltem; 

11 } 

12 } 


This ensures that, only integer objects can be put in the field and a ciassCastException can't occur at runtime, only compile-time error can occur. Unfortunately, it can be used 
only with integer objects. If you want to use the same dass in another context with strings, you have to generahze the type like this: 

Code listing 4.35: Repository.java 

;-1 

i ■ 

i 1 public dass Repository { 1 

i 1 

i 2 ' 

i 1 

i 3 public Object item; 1 

i 1 

i 4 ' 

i 1 

i 5 public Object getltem() { 1 

i 1 

i 6 return item; 1 

i 1 

i 7 } ' 

i 1 

i 8 1 

i 1 

i 9 public void setltem (Integer newltem) {■ 

110 item = newltem; 1 

i 1 

111 } 1 

i 1 

il 2 1 

i 1 

il3 public void setltem (String newltem) { 1 

i 1 

il 4 item = newltem; 1 

Il 5 } 1 

Ii 6 } ; 


But you will have CiassCastException at runtime again and you can't easily use your field. The solution is to use Generics. 

Generic dass 

A generic dass does not hard code the type of a field, a return value or a parameter. The dass only indicates that a generic type should be the same, for a given object instance. The 
generic type is not specified in the dass definition. It is specified during object instantiation. This allows the generic type to be different from an instance to another. So we should 
write our dass this way: 

Code listing 4.36: Repository.java 


[public dass Repository<T> { 
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1 

I 1 

2 


i 3 

public T item; 


! 4 



i 5 

public T getltem () { 


i 6 

return item; 


i 7 

} 


i 8 



i 9 

public void setltem (T newltem) { 


IlO 

item = newltem; 


ill 

} 


Il 2 

i 

I- - 

} 

-1 


Here, the generic type is defined after the name of the dass. Any new identifier can be chosen. Here, we have chosen T, which is the most common choice. The actual type is 
defined at the object instantiation: 



Code section 4.35: Instantiation. 

;-1 

[l Repository<Integer> arithmeticRepository = new Repository<Integer> (i 

■2 arithmeticRepository. setltem (new Integer(l)); 

i3 Integer number = arithmeticRepository. getltem (); 1 

|4 ! 

■5 Repository<String> textualRepository = new Repository<String>(); f 

[6 textualRepository. setltem ( "Hello!") ; ■ 

■7 String message = textualRepository. getItem (); 

I_ 1 


Although each object instance has its own type, each object instance is still strongly typed: 

A Code section 4.36: Compile error. 

I-1 

i i 

il Repository<Integer> arithmeticRepository = new Repository<Integer>() ; i 

,2 arithmeticRepository. setltem ( "Hello!" ) ; 8 

i i 

i i 

i-1 

A dass can define as many generic types as you like. Choose a different identifier for each generic type and separate them by a comma: 

Code listing 4.37: Repository.java 


1 public dass Repository<T, U> { 

2 

3 public T item; 

4 

5 public U anotherltem; 

6 

7 public T getltem () { 

8 return item; 

9 } 

10 

11 public void setltem (T newltem) { 

12 item = newltem; 

13 } 

14 

15 public U getAnotherItem () { 

16 return anotherltem; 

17 } 

18 

19 public void setAnotherItem (U newltem) { 

20 anotherltem = newltem; 

21 } 

22 } 


When a type that is defined with generic (for example, coiiection<T>) is not used with generics (for example, Collection) is called a raw type. 


Generic method 


A generic type can be defined for just a method: 

j^P Code section 4.37: Generic method. 

[1 public <D> D assign (Collection<D> generic, D obj) 
■2 generic . add (ob j ) ; 

[3 return obj; 

|4 } 


Here a new identifier (D) has been chosen at the beginning of the method declaration. The type is specific to a method call and different types can be used for the same object 
instance: 



Code section 4.38: Generic method call. 

-1 


’l Collection<Integer> numbers = new ArrayList<Integer>(); 
i2 Integer number = assign(numbers, new Integer(1)); 

,3 Collection<String> texts = new ArrayList<String>(); 

■4 String text = assign(texts, "Store it. " ); 


I 


The actual type will be defined by the type of the method parameter. Hence, the generic type can’t be defined only for the return value as it wouldn’t be resolved. See the Class<T> 
section for a solution. 


Test your knowledge 

Question 4.8: Consider the following dass. 
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Question 4.8: Question8.java 

j-1 

i 1 public dass Question8<T> { 1 

! 2 public T item; 1 

! 3 1 

! 4 public T getltem () { 1 

i 5 return item; 1 

! 6 } ; 

! 7 1 

i 8 public void setltem (T newltem) { 1 

i 9 item = newltem; 1 

!io } ; 

In 1 

112 public static void main (String[] args) { 1 

113 Question8<String> aQuestion = new Question8<String>(); 1 

114 aQuestion. setltem ( "Open your mind.") ; 1 

115 aQuestion. display (aQuestion. getltem ()); 1 

!l 6 } | 

!l 7 1 

il8 public void display (String parameter) { 1 

11 9 System. out . println ("Here is the text: " + parameter); 1 

',20 } \ 

',21 ! 

122 public void display (Integer parameter) { 1 

123 System. out . printin ( "Here is the number: " + parameter); 1 

',2 4 } I 

',2 5 | 

i26 public void display (Object parameter) { ’ 

,21 System. out . printin ( "Here is the object: " + parameter);' 

■2 8 } | 

12 9 } ; 


What will be displayed on the console? 


Answer 




Console for Answer 4.8 


iHere is the text: Open your mind. 


aQuestion . getltem () is typed as ä String. 


Wildcard Types 


As we have seen above, generics give the impression that a new Container type is created with each different type parameter. We have also seen that in addition to the normal type 
checking, the type parameter has to match as well when we assign generics variables. In some cases this is too restrictive. What if we would like to relax this additional checking? 
What if we would like to define a collection variable that can hold any generic collection, regardless of the parameter type it holds? The wildcard type is represented by the 
character <?>, and pronounced Unknown, or Any-Type. Any-Type can be expressed also by <? extends ob ject>. Any-Type includes Interfaces, not only Classes. So now we 
can define a collection whose element type matches anything. See below: 



Code section 4.39: Wildcard type. 

■-i 

■1 Collection<?> collUnknown; i 

I_ I 


Upper bounded wildcards 

You can specify a restriction on the types of classes that may be used. For example, <? extends ciassName> only allows objects of dass ciassName or a subclass. For example, to 
create a collection that may only contain "Serializable" objects, specify: 

Code section 4.40: Collection of serializable subobjects. 

I-, 

il Collection<String> textColl = new ArrayList<String>() ; i 
|2 : 

■3 Collection<? extends Serializable> serColl = textColl; 1 

l-1 



The above code is valid because the string dass is serializable. Use of a dass that is not serializable would cause a Compilation error. The added items can be retrieved as 
serializable object. You can call methods of the serializable interface or cast it to string. The following collection can only contain objects that extend the dass Animal. 


Code listing 4.38: Dog.java 


1 dass Dog extends Animal { 

2 } 



Code section 4.41: Example of subclass. 

;-1 

[l // Create "Animal Collection" variable , 

■2 Collection<? extends Animal> animalColl = new ArrayList<Dog>() ; [ 

L_! 


Lower bounded wildcards 

<? super ClassName> specifies a restriction on the types of classes that may be used. For example, to declare a Comparator that can compare Dogs, you use: 
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Code section 4.42: Superclass. 

■- 1 


■1 Comparator<? super Dog> myComparator; i 

l_ I 


Now suppose you define a comparator that can compare Animais: 


Code section 4.43: Comparator. 


1 dass AnimalComparator implements Comparator<Animal> { 

2 int compare (Animal a. Animal b) { 

3 //... 

4 } 

5 } 



Since Dogs are Animais, you can use this comparator to compare Dogs also. Comparators for any superclass of Dog can also compare Dog; but comparators for any strict subclass 
cannot. 



Code section 4.44: Generic comparator. 


i 


1 Comparator<Animal> myAnimalComparator = new AnimalComparator(); 

2 

3 static int compareTwoDogs (Comparator<? super Dog> comp, Dog dogl, Dog dog2) { 

4 return comp. compare (dogl, dog2); 

5 } 


L 


The above code is valid because the Animal dass is a supertype of the Dog dass. Use of a dass that is not a supertype would cause a Compilation error. 

Unbounded wildcard 


The advantage of the unbounded wildcard (i.e. <?>) compared to a raw type (i.e. without generic) is to explicitly say that the parameterized type is unknown, not any type. That 
way, all the operations that implies to know the type are forbidden to avoid unsafe Operation. Consider the following code: 


m 


Code section 4.45: Unsafe Operation. 


il public void addAtBottom (Collection anyCollection) { 

[2 anyCollection . add (new Integer (1) ) ; 

■3 } 


This code will compile but this code may corrupt the collection if the collection only contains strings: 


m 


Code section 4.46: Corruption of list. 


1 List<String> col = new ArrayList<String>(); 

2 addAtBottom(col); 

3 col. get ( 0) . endsWith ("."); 


□I 


Console for Code section 4.46 

-------------------------------------------------------------------------------------------- 

i 

lException in thread "main" java.lang.ClassCastException: java.lang.Integer incompatible with java.lang.String 

i 

lat Example . main (Example . j ava : 17 ) 


This Situation could have been avoided if the addAtBottom (Collection) method was defined with an unbounded wildcard: addAtBottom (Coiiection<?>) . With this signature, it 
is impossible to compile a code that is dependent of the parameterized type. Only independent methods of a collection (ciear (), isEmpty (), iterator (), remove (Object o), 
size (), ...) can be called. For instance, addAtBottom (Coiiection<?>) could contain the following code: 


m 


Code section 4.47: Safe Operation. 


public void addAtBottom (Collection<?> anyCollection) 
Iterator<?> iterator = anyCollection. iterator (); 
while ( iterator. hasNext () ) { 

System. out .print (iterator. next () ) ; 


} 


} 


Class<T> 

Since Java 1.5, the dass java. lang. dass is generic. It is an interesting example of using generics for something other than a Container dass. For example, the type of String.class 
is ciass<string>, and the type of Serializable.class is ciass<seriaiizabie>. This can be used to improve the type safety of your reflection code. In particular, since the 
newinstance () method in Class now returns T, you can get more precise types when creating objects reflectively. Now we can use the newinstance () method to return a new 
object with exact type, without casting. An example with generics: 

Code section 4.48: Automatic cast. 


1 Customer cust = Utility.createAnyObject(Customer.class); // No castingi 

2 ... 

3 public static <T> T createAnyObject (Class<T> cls) { 

4 T ret = null; 

5 try { 

6 ret = cls .newinstance (); 

7 } catch (Exception e) { 

8 // Exception Handling 

9 } 

10 return ret; 

11 } 



The same code without generics: 

Code section 4.49: Former Version. 

I-1 

1 1 Customer cust = (Customer) Utility.createAnyObject(Customer.class); // Casting is neededi 
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! 2 ... 

[ 3 public static Object createAnyObject (Class cls) { 
i 4 Object ret = null; 

! 5 try { 

1 6 ret = cls . newlnstance () ; 

i 7 } catch (Exception e) { 

1 8 // Exception Handling 

I 9 } 

,10 return ret; 

;H } 

I_ 


Motivation 

Java was long criticized for the need to explicitly type-cast an element when it was taken out of a "container/collection" class. There was no way to enforce that a "collection" class 
contains only one type of object (e.g., to forbid at compile time that an integer object is added to a Collection that should only contain strings). This is possible since Java 1.5. 
In the first couple of years of Java evolution, Java did not have a real competitor. This has changed by the appearance of Microsoft C#. With Generics Java is better suited to 
compete against C#. Similar constructs to Java Generics exist in other languages, see Generic programming for more information. Generics were added to the Java language syntax 
in Version 1.5. This means that code using Generics will not compile with Java 1.4 and less. Use of generics is optional. For backwards compatibility with pre-Generics Code, it is 
okay to use generic classes without the generics type specification (<t>). In such a case, when you retrieve an object reference from a generic object, you will have to manually cast 
it from type Object to the correct type. 

Note for C++ programmers 

Java Generics are similar to C++ Templates in that both were added for the same reason. The syntax of Java Generic and C++ Template are also similar. There are some differences 
however. The C++ template can be seen as a kind of macro, in that a new copy of the code is generated for each generic type referenced. All extra code for templates is generated 
at Compiler time. In contrast, Java Generics are built into the language. The same code is used for each generic type. For example: 

Code section 4.50: Java generics. 


[l Collection<String> collString = new ArrayList<String>(); 

■2 Collection<Integer> colllnteger = new ArrayList<Integer>(); 

1_ 



Both these objects appear as the same type at runtime (both ArrayList's). The generic type information is erased during Compilation (type erasure). For example: 



Code section 4.51: Type erasure. 

I-1 

'1 public <T> void method(T argument) {■ 

i2 T variable; , 

|3 ... ' 

|4 } ! 

I_I 


is transformed by erasure into: 



Code section 4.52: Transformation. 
- 1 


[1 public void method (Object argument) { 
i2 Object variable; 

|3 

■4 } 


I 


Test your knowledge 

Question 4.9: Consider the following class. 



Question 4.9: Question9.java 


-, 

1 import java.util.ArrayList; 1 

2 import java.util.Collection; 1 

3 1 

4 public class Question9 { 1 

5 public static void main (String[] args) { 1 

6 Collection<String> collectionl = new ArrayList<String> () ; 1 

7 Collection<? extends Object> collection2 = new ArrayList<String> () ; 1 

8 Collection<? extends String> collection3 = new ArrayList<String>(); 1 

9 Collection<? extends String> collection4 = new ArrayList<Object>(); 1 

10 Collection<? super Object> collection5 = new ArrayList<String> (); 1 

11 Collection<? super Object> collection6 = new ArrayList<Object> (); 1 

12 Collection<?> collection7 = new ArrayList<String>(); 1 

13 Collection<? extends Object> collection8 = new ArrayList<?>(); 1 

14 Collection<? extends Object> collection9 = new ArrayList<Object>(); 1 

15 Collection<? extends Integer> collectionlO = new ArrayList<String>() ; 1 

16 Collection<String> collectionll = new ArrayList<? extends String>(); 1 

17 Collection collectionl2 = new ArrayList<String> () ; 1 

is } ; 

19 } ; 


Which lines will generate a compile error? 


Answer 

Answer 4.9: Answer9.java 

i-1 

i i 

1 1 import java.util.ArrayList; 1 

1 2 import java.util.Collection; 1 

1 3 1 

i i 

1 4 public class Answer9 { 1 

1 5 public static void main (String[] args) { 1 

1 6 Collection<String> collectionl = new ArrayList<String>(); 1 

1 7 Collection<? extends Object> collection2 = new ArrayList<String>(); 1 
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i 8 Collection<? extends String> collection3 = new ArrayList<String> (); 

i 9 Collection<? extends String> collection4 = new ArrayList<Object> (); 

110 Collection<? super Object> collection5 = new ArrayList<String>(); 

111 Collection<? super Object> collection6 = new ArrayList<Object>(); 

112 Collection<?> collection7 = new ArrayList<String> () ; 

113 Collection<? extends Object> collection8 = new ArrayList<?>(); 

114 Collection<? extends Object> collection9 = new ArrayList<Object> (); 

115 Collection<? extends Integer> collectionlO = new ArrayList<String>( 

116 Collection<String> collectionll = new ArrayList<? extends String>() 

117 Collection collectionl2 = new ArrayList<String>(); 

Il 8 } 

■ 19 } 



■ Line 9: Object does not extend String. 

■ Line 10: String is not a SUperclasS of Object. 

■ Line 13: ArrayList<?> can't be instantiated. 

■ Line 15; Integer does not extend String. 

■ Line 16: ArrayList<? extends st ring> can’t be instantiated. 
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■ This page was last modified on 30 January 2016, at 19:08. 

■ Text is available under the Creative Commons Attribution-ShareAlike License.; additional terms may apply. By using this site, you agree to the Terms of Use and Privacy 
Policy. 


134 sur 134 


30/01/2016 20:09 





Java Programming/Print version2 - Wikibooks, open books for an open... 


https://en. wikibooks .org/w/index.php ?title=Java_Programming/Print_ve... 


Java Programming/Print version2 
Aggregate 

In the previous chapters, we have discovered the array. An array Stores a group of primitive types. To group objects, or to reference a group of objects, we can use Java aggregate classes. 
There are two main interfaces, those are java.utii. Collection and java. utn.Map . Implementations for those interfaces are not interchangeable. 

Collection 

The implementations of java.utn .Collection interface are used for grouping simple java objects. 

Example 

We can group together all patients in a Hospital to a "patient" collection. 

Map 

The implementations of java. utii. Map interface are used to represent mapping between "key" and "value" objects. A Map represents a group of "key" objects, where each "key" object is 
mapped to a "value" object. 

Example 

For each patient, there is one and only one main nurse assigned to. That association can be represented by a "patient-nurse" Map. 

Choice 

A collection is better when you have to access all the items at once. A map is better when you have to randomly access an item regularly. 

Before selecting a particular collection implementation, ask the following question: 

Can my collection contain the same elements, i.e. are duplicates allowed? 

Can my collection contain the null element? 

Should the collection maintain the order of the elements? Is the order important in any way? 

How do you want to access an element? By index, key or just with an iterator? 

Does the collection need to be synchronized? 

From a performance perspective, which one needs to befaster, Updates or reads? 

From a usage perspective, which Operation will be more frequent, Updates or reads? 

Once you know your needs, you can select an existing implementation. But first decide if you need a Collection, or a Map. 

Note that the above associations are explicit. The objects them-self do not have any knowledge/information about that they are part in an association. But creating explicit associations 
between simple java objects is the main idea about using the aggregate/collection classes. 


Collection 


The most basic collection interface is called collection. This interface gives the user a generic usage of a collection. All collections need to have the same basic operations. Those are: 

■ Adding element(s) to the collection 

■ Removing element(s) from the collection 

■ Obtaining the number of elements in the collection 

■ Listing the contents of the collection, (Iterating through the collection) 


Code listing 5.1: CollectionProgram.java 



Console for Code listing 5.1 


1 Import java.util.Collection; // Interface 

2 Import java.util.ArrayList ; // Implementation 

3 

4 public dass CollectionProgram { 

5 

6 public static void main (String[] args) { 

7 Collection myCollection = new ArrayList(); 

8 myCollection. add ("1") ; 

9 myCollection. add (" 2 ") ; 

10 myCollection. add (" 3 ") ; 

11 System.out.println("The collection contains " + myCollection.size() + " item(s). 

12 

13 myCollection. clear (); 

14 if (myCollection. isEmpty ()) { 

15 System. out . println (" The collection is empty."); 

16 } eise { 

17 System. out . println (" The collection is not empty."); 

18 } 

19 } 

20 } 


The collection contains 3 item(s). 
The collection is empty. 


When you put an object in a collection, this object is not actually in the collection. Only its object reference is added to the collection. This means that if an object is changed after it was put 
in an collection, the object in the collection also changes. The code listing 5.2 computes the seven next days from tomorrow and störe each date in a list to read it after. See what happens: 


Code listing 5.2: SevenNextDays.java 



Console for Code listing 5.2 


-, 

1 Import java.util.ArrayList; 1 


The next day is: Sat Feb 6 19:09:22 UTC 2016 
The next day is: Sat Feb 6 19:09:22 UTC 2016 
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2 Import java . util . Calendar ; 

3 Import java . util . Collection; 

4 Import java . util . Date; 

5 Import java.util . GregorianCalendar; 

6 

7 public dass SevenNextDays { 

8 

9 public static void main (String[] args) { 

10 

11 // The calendar is set at the current date: today 

12 Calendar calendar = new GregorianCalendar(); 

13 

14 Collection collectionOfDays = new ArrayList (); 

15 Date currentDate = new Datei); 

16 for (int i = 0; i < 7; ++i) { 

17 // The calendar is now set to the next day 

18 calendar. add (Calendar. DATE , 1); 

19 currentDate. setTime (calendar. getTimelnMi1lis ()); 

20 

21 collectionOfDays. add (currentDate); 

22 } 

23 

24 for (Object oneDay : collectionOfDays) { 

25 System. out . println (" The next day is: " + oneDay); 

26 } 

27 } 

28 } 


The 

next 

day 

is : 

Sat 

Feb 

6 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Sat 

Feb 

6 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Sat 

Feb 

6 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Sat 

Feb 

6 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Sat 

Feb 

6 

19:09:22 

UTC 

2016 


Each collection items were said to be updated to a different date but they all have been updated to the last one. It means that each update has updated all the collection items. And this is the 
case. The currentDate has been used to fill all the collection items. The collection didn't keep trace of the added values (one of the seven dates) but the added object references 
(currentDate). So the collection contains the same object seven times! To avoid this issue, we should have coded it this way: 


Code listing 5.3: ActualSevenNextDays.java 



1 import java.util.ArrayList; 

2 import java.util.Calendar ; 

3 import java.util . Collection; 

4 import java.util.Date; 

5 import java.util.GregorianCalendar ; 

6 

7 public dass ActualSevenNextDays { 

8 

9 public static void main (String[] args) { 

10 

11 // The calendar is set at the current date: today 

12 Calendar calendar = new GregorianCalendar(); 

13 

14 Collection collectionOfDays = new ArrayList (); 

15 for (int i = 0; i < 7; ++i) { 

16 Date currentDate = new Date(); 

17 // The calendar is now set to the next day 

18 calendar. add (Calendar. DATE , 1); 

19 currentDate. setTime (calendar. getTimelnMi11is ()); 

20 

21 collectionOfDays. add (currentDate); 

22 } 

23 

24 for (Object oneDay : collectionOfDays) { 

25 System. out . println (" The next day is: " + oneDay); 

26 } 

27 } 

28 } 


Console for Code listing 5.3 


The 

next 

day 

is : 

Sun 

Jan 

31 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Mon 

Feb 

1 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Tue 

Feb 

2 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Wed 

Feb 

3 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Thu 

Feb 

4 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Fr i 

Feb 

5 

19:09:22 

UTC 

2016 

The 

next 

day 

is : 

Sat 

Feb 

6 

19:09:22 

UTC 

2016 


Now each time we add an item to the collection, it is a different instance. All the items evolve separately. To add an object in a collection and avoid this item to be changed each time the 
source object is changed, you have to copy or clone the object before you add it to the collection. 

Generics 


Objects put into a collection are upcasted to object dass. It means that you need to cast the object reference back when you get an element out from the collection. It also means that you 
need to know the type of the object when you take it out. If a collection contains different types of objects, we will have difficulty finding out the type of the objects obtained from a 
collection at run time. Let's use a collection with any objects in it: 


S Code section 5.1: Collection feeding. 


1 Collection ageList = new ArrayList (); 

2 ageList. add (new Integer ( 46)); 

3 ageList. add ("50"); 


Code section 5.2: Collection reading. 


1 Integer sum = new Integer(0); 

2 for (Object age : ageList) { 

3 sum = sum. add ((Integer) age) ; 

4 } 

5 

6 if (!ageList. isEmpty ()) { 

7 System.out.println("The average age is " + sum / ageList.size()) ; 

8 } 


Console for Code section 5.2 


iClassCastException. 


This error could have been fixed earlier, at compile time, using generic types. 

The Generics has been added since JDK Version 1.5. It is an enhancement to the type System of the Java language. All collection implementations since 1.5 now have one parameterized 
type <E> added. The E refers to an Element type. When a collection is created, the actual Element type will replace the E. In the collection, the objects are now upcasted to E dass. 



Code section 5.3: Collection with generics. 
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1 Collection<Integer> ageList = new ArrayList<Integer> (); 

2 ageList. add (new Integer ( 4 6) ) ; // Integer can be addecL 

3 ageList. add ("5 0 ") ; // Compilation error, ageList can have only Integers insi 


ageList is a collection that can contain only Integer objects as elements. No casting is required when we take out an element. 



Code section 5.4: Item reading. 



'1 Integer age = ageList. get ( 0); i 



Generics is not mandatory but it is often used with the collection classes. 

Collection classes 

There is no direct implementation for the java. utii. Collection interface. The Collection interface has five sub interfaces. 


Figure 1: The five sub interfaces of the java.utii .Collection interface. 

O coleaon 

O Sei I |# Lis I I# Queue I 

O 5or*d5e; O slodongQueue 


Set 

A set collection contains unique elements, so duplicates are not allowed. It is similar to a mathematical Set. When adding a new item to a set, the set calls the method int hashcode () of 
the item and compare it to the hash code of all the already inserted items. If the hash code has not been found, the item is added. If it is, the set now call the booiean equais (Object 
ob j ); method with all the set items. If all calls returns false, the item is inserted. If not, the item is not inserted. 



Figure 2: Set dass diagram. 

«Interface» 

O Collection 


O AbstractCollection 

«nterface» 

OSet 


© AbstrsctSet 



• Class > dass 

••interface» 

O SortedSet 

O TreeSet 
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Slrvre 1.4 

© LlnkedHashSet _ . _ 

Snce 1.5 





java.util.HashSet<E> 

This is the basic implementation of the set interface. Not synchronized. Allows the null elements 
java.util.TreeSet<E> 

Elements are sorted, not synchronized. null not allowed 

java.util.CopyOnWriteArraySet<E> 

Thread safe, a fresh copy is created during modification Operation. Add, update, delete are expensive. 

java.util.EnumSet<E extends Enum<E» 

All of the elements in an enum set must come from a single enum type that is specified, explicitly or implicitly, when the set is created. Enum sets are represented internally as bit 
vectors. 

java.util.LinkedHashSet<E> 

Same as HashSet, plus defines the iteration ordering, which is the order in which elements were inserted into the set. 

Detecting duplicate objects in Sets 

Set cannot have duplicates in it. You may wonder how duplicates are detected when we are adding an object to the set. We have to see if that object exists in the Set or not. It is not 
enough to check the object references, the objects' values have to be checked as well. 

To do that, fortunately, each java object has the booiean equais (Object ob j ), method available inherited from object. You need to override it. That method will be called by the Set 
implementation to compare the two objects to see if they are equal or not. 

There is a problem, though. What if I put two different type of objects to the Set. I put an Apple and an Orange. They can not be compared. Calling the equais () method would cause a 
ciassCastException. There are two Solutions to this: 

■ Solution one : Override the int hashcode () method and return the same values for the same type of objects and return different values for different type of objects. The equais () 
method is used to compare objects only with the same value of hashCode. So before an object is added, the Set implementation needs to: 

■ find all the objects in the Set that have the same hashCode as the candidate object hashCode 

■ and for those, call the equais ( ) methods passing in the candidate object 

■ if any of them returns true, the object is not added to the Set. 

■ Solution two : Create a super dass for the Apple and Orange, let's call it Fruit dass. Put Fruits in the Set. You need to do the following: 

■ Do not override the equais () and hashcode ( ) methods in the Apple and Orange classes 
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■ Create appieEquais () method in the Apple dass, and create orangeEquais () method in the Orange dass 

■ Override the hashcode () method in the Fruit dass and return the same value, so the equais () is called by the Set implementation 

■ Override the equais () method in the Fruit dass for something like this. 



Code section 5.5: equais method implementation. 


1 public boolean equais (Object obj) { 

2 boolean ret - false; 

3 if (this instanceof Apple && 

4 obj instanceof Apple) { 

5 ret = this . appieEquais (obj); 

6 } eise if (this instanceof Orange && 

7 obj instanceof Orange) { 

8 ret = this . orangeEquais (obj); 

9 } eise { 

10 // Can not compare Orange to Apple 

11 ret = false; 

12 } 

13 return ret; 

14 } 


Note: 


■ Only the objects that have the same hashCode will be compared. 

■ You are responsible to override the equais () and hashcode () methods. The default implementations in Object won't work. 

■ Only override the hashcode () method if you want to eliminate value duplicates. 

■ Do not override the hashcode () method if you know that the values of your objects are different, or if you only want to prevent adding the exactly same object. 

■ Beware that the hashcode ( ) may be used in other collection implementations, like in a Hashtable to find an object fast. Overriding the default hashcode ( ) method may affect 
performance there. 

■ The default hashCodes are unique for each object created, so if you decide not to override the hashcode () method, there is no point overriding the equais () method, as it won't be 
called. 

SortedSet 

The SortedSet interface is the same as the Set interface plus the elements in the SortedSet are sorted. It extends the Set Interface. All elements in the SortedSet must implement the 
Comparable Interface, furthermore all elements must be mutually comparable. 

Note that the ordering maintained by a sorted set must be consistent with equais if the sorted set is to correctly implement the Set interface. This is so because the Set interface is defined in 
terms of the equais Operation, but a sorted set performs all element comparisons using its compare method, so two elements that are deemed equal by this method are, from the standpoint of 
the sorted set, equal. 

The SortedSet interface has additional methods due to the sorted nature of the 'Set'. Those are: 


E first (); 

returns the first element 

E last () ; 

returns the last element 

SortedSet headSet(E toElement); 

returns from the first, to the exclusive toElement 

SortedSet tailSet(E fromElement); 

returns from the inclusive fromElement to the end 

SortedSet subSet(E fromElement, E 

toElement); 

returns elements ränge from fromElement, inclusive, to toElement, exclusive. (If fromElement and toElement are equal, the returned 
sorted set is empty.) 


List 

In a list collection, the elements are put in a certain order, and can be accessed by an index. Duplicates are allowed, the same element can be added twice to a list. It has the following 
implementations: 


Figure 3: List dass diagram. 
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Sin'ce 1.5 


java.util. Vector <E> 

Synchronized, use in multiple thread access, otherwise use ArrayList. 

java.util.Stack<E> 

It extends dass Vector with five operations that allow a vector to be treated as a stack. It represents a last-in-first-out (LIFO) stack of objects. 

java.util.ArrayList<E> 

The basic implementation of the List interface is the ArrayList. The ArrayList is not synchronized, not thread safe. vector is synchronized, and thread safe. vector is slower, 
because of the extra overhead to make it thread safe. When only one thread is accessing the list, use the ArrayList. Whenever you insert or remove an element from the list, there are 
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extra overhead to reindex the Hst. When you have a large Hst, and you have lots of insert and remove, consider using the LinkedList. 

java.util.LinkedList<E> 

Non-synchronized, update Operation is faster than other Hsts, easy to use for Stacks, queues, double-ended queues. The name LinkedList implies a special data structure where the 
elements/nodes are connected by pointers. 


Head Node 1 Node 2 Node n 


Size I _ _ _ 

_I I I point I I I point I III 

First I-> | Data I to next I-> | Data I to next | — ... —> | Data I null I 

elem | I_I_I I_I_I I_I_I 


Last 

elem 


Each node is related to an item of the linked Hst. To remove an element from the Hnked Hst the pointers need to be rearranged. After removing Node 2: 


Head 

Node 

1 


Node 

2 


Node n 

- 1 

I Size | 



I 



I 



1 First|- 

1 

-> I Data 

1 point 

I to next 

1 1 

1 

1 Data 

1 point I 

I to nextI 

1 

1 1 1 
. -->| Data I null I 



elem 


Last 

elem 


L 


javax.management.AtributeList<E> 

Represents a Hst of values for attributes of an MBean. The methods used for the insertion of Attribute objects in the AttributeList overrides the corresponding methods in the 
superclass ArrayList. This is needed in order to insure that the objects contained in the AttributeList are only Attribute objects. 

javax.management.relation.RoleList<E> 

A RoleList represents a Hst of roles (Role objects). It is used as parameter when creating a relation, and when trying to set several roles in a relation (via ’setRoles()' method). It is 
returned as part of a RoleResult, to provide roles successfuUy retrieved. 

javax.management.relation.RoleUnresolvedList<E> 

A RoleUnresolvedList represents a Hst of RoleUnresolved objects, representing roles not retrieved from a relation due to a problem encountered when trying to access (read or write 
to roles). 

Queue 

The Queue interface provides additional insertion, extraction, and inspection operations. There are FTFO (first in, first out) and LIFO (last in, first out) queues. This interface adds the 
foUowing operations to the Collection interface: 


E element() 

Retrieves, but does not remove, the head of this queue. This method differs from the peek method only in that it throws an exception if this queue is empty 

boolean öfter(E o) 

Inserts the specified element into this queue, if possible. 

E peek () 

Retrieves, but does not remove, the head of this queue, returning null if this queue is empty 

E poll () 

Retrieves and removes the head of this queue, or nuU if this queue is empty 

E remove () 

Retrieves and removes the head of this queue. This method differs from the poU method in that it throws an exception if this queue is empty. 


Figure 4: Queue dass diagram. 
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0 SynchronousQueue 


java.util.BlockingQueue<E> 

waits for the queue to become non-empty when retrieving an element, and waits for space to become available in the queue when storing an element. Best used for producer- 
consumer queues. 

java.util.PriorityQueue<E> 

Orders elements according to an order/priority specified at construction time, null element is not aUowed. 

java.util.concurrent.ArrayBlockingQueue<E> 

Orders elements FIFO; synchronized, thread safe. 

java.util.concurrent.SynchronousQueue<E> 

each put must wait for a take, and vice versa, does not have any internal capacity, not even a capacity of one, an element is only present when you try to take it; you cannot add an 
element (using any method) unless another thread is trying to remove it. 

Complete UML dass diagram 


Figure 5: UML dass diagram of the Collection interfaces and their implementations. 
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Synchronization 

Synchronization is important when you are running several threads. Beware, synchronization does not mean that your collection is thread-safe. A thread-safe collection is also called a 
concurrent collection. Most of the populär collection classes have implementations for both single thread and multiple thread environments. The non-synchronized implementations are 
always faster. You can use the non-synchronized implementations in multiple thread environments, when you make sure that only one thread Updates the collection at any given time. 

A new Java JDK package was introduced at Java 1.5, that is java .utii. concurrent. This package supplies a few Collection implementations designed for use in multi-threaded 
environments. 

The following table lists all the synchronized collection classes: 



synchronized 

non-synchronized 


java.util. Vector 

java.util. ArrayList 

List 

java.util. Stack 



java.util.LinkedList 


java.util. concurrent. CopyOnWrite ArrayList 




java.util.TreeSet 

Set 


java.util.HashSet 


java.util.LinkHashSet 


java.util.concurrent.CopyOnWriteArraySet 



Custom collection 

The Java JDK collection implementations are quite powerful and good, so it is unlikely that you will need to write your own. The usage of the different collections are the same but the 
implementations are different. If the existing collection implementations do not meet your needs, you can write your Version of the implementation. Your Version of the implementation just 
needs to implement the same java. utii . Collection interface, then you can switch to using your implementation and the code that is using the collection does not need to be changed. 

Use the Collection interface if you need to keep related (usually the same type of) objects together in a collection where you can: 

■ Search for a particular element 

■ List the elements 

■ Maintain and/or change the order of the elements by using the collection basic operations (Add, Remove, Update,..) 

■ Access the elements by an index number 

The advantages of using the collection interface are: 

■ Gives a generic usage, as we talked about above, it is easy to switch implementation 

■ It makes it easy to convert one type of collection to another. 


The Collection interface defines the following basic operations: 


boolean add(E o); 

Using Element type E 

boolean addAii(Collection c) ; 


boolean remove (Object o); 


boolean removeAll(Collection c) ; 


boolean retainAll(Collection c) ; 

Return true if the collection has changed due to the Operation. 


Note that in addAii () we can add any type of collection. This is the beauty of using the Collection interface. You can have a LinkedList and just call the addAii (list) method, passing 
in a list. You can pass in a vector, an ArrayList, a HashSet, a TreeSet, a YourimpOfCollection, ... All those different types of collection willbe magically converted to a LinkedList. 

Let's have a closer look at this magic. The conversion is easy because the Collection interface defines a Standard way of looping through the elements. The following code is a possible 
implementation of addAii () method of the LinkedList. 

Code section 5.6: Collection transfer. 


1 Import java.utii.Collection 
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2 Import java.util.Iterator 

3 ... 

4 public boolean addAll (Collection coli) { 

5 int sizeBefore = this.sizeO; 

6 Iterator iter = coli. iterator (); 

7 while (iter. hasNext ()) { 

8 this . add (iter. next ()); 

9 } 

10 if (sizeBefore > this.sizeO) { 

11 return true; 

12 } eise { 

13 return false; 

14 } 

15 } 


The above code just iterates through the passed in collection and adds the elements to the linked list. You do not have to do that, since that is already defined. What you might need to code 
for is to loop through a Customer collection: 



Code section 5.7: Iteration on a collection. 




1 Import java.util.Collection 

2 import java.util.Iterator 

3 import java . yourcompany . Customer 

4 ... 

5 public String printCustoraerNaraes (Collection customerCol1) { 

6 StringBuffer buf = new StringBuffer (); 

7 

8 Iterator iter = customerColl. iterator (); 

9 while (iter. hasNext ()) { 

10 Customer cust = (Customer) iter. next (); 

11 buf. append (cust. getName ()); 

12 buf. append ( "\n" ); 

13 } 

14 return buf. toString (); 

15 } 


Notice two things: 

■ The above code will work for all type of collections. 

■ We have to know the type of objects inside the collection, because we call a method on it. 


ArrayList 

The ArrayList dass extends AbstractList and implements the List interface. ArrayList Supports dynamic arrays that can grow as needed. 

Standard Java arrays are of a fixed length. After arrays are created, they cannot grow or shrink, which means that you must know in advance how many elements an array will hold. 
Array lists are created with an initial size. When this size is exceeded, the collection is automatically enlarged. When objects are removed, the array may be shrunk. 

Initializing 

The ArrayList dass Supports three constructors. The first constructor builds an empty array list.: 

I-- 

i 

■ArrayList ( ) 

i 

i__ 

The following constructor builds an array list that is initialized with the elements of the collection c. 

I-- 

i 

■ArrayList (Collection c) 

i 

L_ 

The following constructor builds an array list that has the specified initial capacity. The capacity is the size of the underlying array that is used to störe the elements. 

The capacity grows automatically as elements are added to an array list. 

i-- 

i 

« ArrayList (int capacity) 

i 

L-- 

Methods 


~i 


ArrayList defines following methods: 

Adding Element in ArrayList 


■ Inserts the specified element at the specified position index in this list. Throws IndexOutOfBoundsException if the specified index is out of ränge (index <0 11 index > size()). 

i- 

i 

■void add (int index, Object element) 

i 

L_ 

■ Appends the specified element to the end of this list. 

i- 

i 

Jboolean add (Object o) 

L_ 

■ Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's iterator. Throws NullPointerException if 
the specified collection is null. 

I- 

i 

■boolean addAll (Collection c) 

i 

i_ 

■ Inserts all of the elements in the specified collection into this list, starting at the specified position. Throws NullPointerException if the specified collection is null. 

r- 

i 

■boolean addAll (int index, Collection c) 


Size of ArrayList 


7 sur 77 


30/01/2016 20:10 























Java Programming/Print version2 - Wikibooks, open books for an open... https://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve 


■ Returns the number of elements in this list. 


'int size () 

I 

L_ 


Adding Element and Size of ArrayList 


Import java.util.*; 

public dass ArrayListDemo { 

public static void main (String[] args) { 

// create an array list 

ArrayList al= new ArrayList(); 

System. out . println (" Initial ArrayList : "+al); 

// add elements to the array list 
al. add ( "A" ); 
al. add ( "B" ); 

//find size of ArrayList 

System. out . println (" Size of al :"+al . size ()); 
// display the array list 

System. out .printin ("Contents of al :"+al); 
al. add (1, "C") ; 

System. out .printin ("Contents of al :"+al); 
System. out .printin ( "Size of al :"+al . size ()); 

} 

} 


Output for Adding Element and Size of ArrayList 


T 



-! 

,Initial ArrayList : [] 1 

Isize of al : 2 1 

iContents of al : [A, B] 1 

iContents of al : [A, C, B] J 

iSize of al : 3 " 

i_1 


Get and Set ArrayList Element 


Returns the element at the specified position in this list. Throws IndexOutOfBoundsException if the specified index is is out of ränge (index < 0 or index >= sizeQ). 


■Object get (int index) 

i 

L_ 


Replaces the element at the specified position in this list with the specified element. Throws IndexOutOfBoundsException if the specified index is is out of ränge (index < 0 or index 


>= size()). 


■Object set (int index, Object element) 

i 

L_ 


Find Index of ArrayList Element 

■ Returns the index in this list of the first occurrence of the specified element, or -1 if the List does not contain this element. 


'int indexOf (Object o) 

I 

L_ 


1 


-1 


■ Returns the index in this list of the last occurrence of the specified element, or -1 if the list does not contain this element. 



'int lastlndexOf (Object o) 



Find Element Contain in ArrayList 


Returns true if this list contains the specified element. More formally, returns true if and only if this list contains at least one element e such that (o==null ? e==null: o.equals(e)). 



'boolean contains (Object o) 



Different Method in ArrayList 



ipublic dass ArrayListDemo { , 

j public static void main (String[] args) { 1 

' // create an array list i 

, ArrayList al = new ArrayList(); , 

i // add elements to the array list i 

| al. add ( "A" ); | 

' al. add ( "B" ); ' 

! al. add ( "C" ); | 

| al. add ( "A" ); j 

' al. add ( "D" ); ! 

| al. add ( "A" ); J 

| al. add ( "E" ); ' 

i System. out .printin ("Contents of al : " + al); i 

' // find index of element in ArrayList ' 

i System. out . println (" Index of D : " + al. indexOf ( "D")) ; | 

’ System. out . println (" Index of A : " + al. indexOf ( "A" )); 1 

i // find index of element in ArrayList , 

1 System. out . println (" Index of A ; " + al. lastlndexOf ( "A" )); ' 

i // get element at given Index 

' System. out . println ( "Element at Second Index ; " + al.get(2)); ' 

i System. out . println ( "Element at Sixth Index : " + al.get(6)); , 

' //set element at given Index i 

i al. set (3, "B" ); // replacing third index element by "B" , 

’ System. out .printin ("Contents of al : " + al); ' 

i //check ArrayList contains given element 

' System. out . println ( "Ar rayList contain D ; " +al. contains ( "D")) ; ' 

i System. out . println ( "Ar rayList contain F : " +al. contains ( "F")) ; , 

; j ; 

i_i 
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Output for Different Method in ArrayList 


Contents of al : [A, B, C, A, D, A, E] 

Index of D : 4 

Index of A : 0 

Index of A : 5 

Element at Second Index : C 

Element at Sixth Index : E 

Contents of al : [A, B, C, B, D, A, E] 

ArrayList contain D : true 

ArrayList contain F : false 


Test your knowledge 
Question: Consider the following code: 


public dass ArrayListDemo { 

public static void main (String[] args) { 

ArrayList al = new ArrayList (); 

al. add ( "A" ); 
al. add ( "B" ); 
al. add ( " C " ); 
al. add ( "E" ); 
al. add ( "F" ); 

al. remove (2); 
al. remove ( "F" ); 

al. set (1, "G"); 
al. add ( "H" ); 
al. set (3, "I"); 

System. out . println (" Size of al : " t al. size ()); 

System. out .printin ("Contents of al : " t al); 

} 

} 


In the example above, what is output? 
Answer 


Size of al : 4 

Contents of al ; [A, G, E, I] 


Some more ArrayList methods: 


Method 

Description 

Object clone() 

Returns a shallow copy of this ArrayList. 

Object [] toArray () 

Returns an array containing all of the elements in this list in the correct order. Throws NullPointerException if the specified 
array is null. 

void trimToSize() 

Trims the capacity of this ArrayList instance to be the list's current size. 

void ensureCapacity(int minCapacity) 

Increases the capacity of this ArrayList instance, if necessary, to ensure that it can hold at least the number of elements 
specified by the minimum capacity argument. 

protected void removeRange(int fromlndex, 

int tolndex) 

Removes from this List all of the elements whose index is between fromlndex, inclusive and tolndex, exclusive. 


Map 

Aside fromthe java .utii .Collection interface, the Java JDK has the java.utn .Map interface as well. It is sometimes also called an Associated Array or a Dictionary. A map defines 
key value mappings. Implementations of the Map interface do not contain collections of objects. Instead they contain collections of key->value mappings. It can be thought of as an array 
where the index doesn't need to be an integer. 

Code section 5.17: Use of a map. 

I-! 

l l 

il Import java . util.Map; i 

|2 Import java.util.Hashtable; j 

'3 . . . 1 

■ i 

i4 Map map = new Hashtable (); i 

'5 1 

i - • • • i 

'6 map. put (key, value); 1 

■ i 



Use the Map interface if you need to keep related objects together in a Map where you can: 

■ Access an element by a key object 

■ Map one object to other 


Figure 5.6: Map Interfaces. 
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o 

o 


java.util.Map<K,V> 

maps keys to values. A map cannot contain duplicate keys; each key can map to at most one value. The Map interface provides three collection views, which allow a map's contents 
to be viewed as a set of keys, collection of values, or set of key-value mappings. The key is usually a non-mutable object. The value object however can be a mutable object. 

java.util.SortedMap<K,V> 

same as the Map interface, plus the keys in the Map are sorted. 

In the above example, the same operations are made with two different map implementations: 


Code listing 5.4: Maplmplementations.java 


1 Import java.util.LinkedHashMap; 

2 Import java.util.Map; 

3 Import java.util.TreeMap; 

4 

5 /** 

6 * Compare the map implementations. 

7 * 

8 * Sauthor xxx 

9 */ 

10 public dass Maplmplementations { 

11 

12 /** 

13 * Compare the map implementations. 

14 * Sparam args The execution Parameters. 

15 */ 

16 public static void raain (String[] args) { 

17 processMap (new LinkedHashMap<String, Integer>()); 

18 

19 processMap (new TreeMap<String, Integer>()); 

20 } 

21 

22 /** 

23 * Use a map: 

24 * 1. Fill the map with key-> value. 

25 * 2. Print all the keys. 

26 * 

27 * Sparam map The used map. 

2 8 */ 

29 public static void processMap (Map<String, Integer> map) { 

30 System. out . printin ( "Process the map"); 

31 map. put ("3", new Integer (3)); 

32 map.put("2", new Integer(2)); 

33 map. put ("1", new Integer (1)); 

34 

35 for (String key : map. keySet ()) { 

36 System. out . println (key); 

37 } 

38 } 

39 } 



Console for Code listing 5.4 


Process the map 
3 
2 
1 

Process the map 
1 
2 
3 


■1 


We see that only the TreeMap has sorted the keys. Beware of the generics. The Map interface is tricky. The methods get () and remove () are not generic. This means that you must be 
careful of the type of the key: 



Code section 5.18: Tricky generics. 

i-1 


1 Map<Integer, String> map = new TreeMap<Integer, String>(); 

2 

3 map. put (new Integer(1), "Watch"); 

4 map. put (new Integer (2), "out") ; 

5 map. put (new Integer(3), "!"); 

6 

7 map.remove ( "2"); 


8 

9 for (String value : map. values ()) { 

10 System. out . println (value); 

11 } 


L 



Console for Code section 5.18 


Watch 

out 


L 


1 


The remove () call has done nothing because " 2 " is a String, not an integer so no key and value has been found and removed. 

Map Classes 

The Map interface has the following implementations: 


Figure 5.7: Map dass diagram. 
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«tnierSace» 

O Map 


0 AbstractMap 


© CorvcurrentHashMap 










«mterfeoe» 

0 SortedMap 


0 TreeMap 









0 HashMap 

0 Hashtable 


0 WeakHashMap 










0LinkedHashMap 


0kie nt ity HashMap 

0 EnumMap 






java.util.TreeMap<E> 

guarantees that the map will be in ascending key order, sorted according to the natural order for the key's dass, not-synchronized. 

java.util.Hashtable<E> 

Synchronized, null can not be used as key 

java.util.HashMap<E> 

is roughly equivalent to Hashtable, except that it is unsynchronized and permits nulls 

java.util.concurrent.ConcurrentHashMap 

same as Hashtable, plus retrieval operations (including get) generally do not block, so may overlap with update operations (including put and remove). 

java.util.WeakHashMap<E> 

entry in a WeakHashMap will automatically be removed when its key is no longer in ordinary use. Non-synchronized. 

java.util.LinkedHashMap<E> 

This linked list defines the iteration ordering, which is normally the order in which keys were first inserted into the map (first insertion-order). Note that insertion order is not affected 
if a key is re-inserted into the map. 

java.util.IdentityHashMap 

This dass implements the Map interface with a hash table, using reference-equality in place of object-equality when comparing keys (and values). In other words, in an 
IdentityHashMap, two keys kl and k2 are considered equal if and only if (ki==k 2 ). (In normal Map implementations (like HashMap) two keys kl and k2 are considered equal if 
andonlyif (kl==null ? k2==null : kl .equals (k2) ).) Not-synchronized. 

java.util.EnuinMap 

All of the keys in an enum map must come from a single enum type that is specified, explicitly or implicitly, when the map is created. Enum maps are represented internally as arrays. 
This representation is extremely compact and efficient. Not-synchronized. 

Thread safe maps 

The following table lists all the synchronized map classes: 


synchronized 

non-synchronized 


java.util.TreeMap 

j ava. util. Ha shtable 

java.util.concurrent.ConcurrentHashMap 

java.util.HashMap 


java.util.LinkedHashMap 


j ava. util. IdentityHashMap 


j ava. util. EnumMap 


Comparing Objects 

In Java, we can distinguish two kinds of equality. 

■ Object reference equality: when two object references point to the same object. 

■ Object value equality: when two separate objects happen to have the same values/state. 

If two objects are equal in reference, they are equal in value too. 

Comparing for reference equality 

The == operator can be used to check if two object references point to the same object. 

Code section 5.19: Reference equality. 

il if (objRefl == objRef2) { i 

|2 // The two object references point to the same object , 

0 } : 



Comparing for value equality 
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To be able to compare two Java objects of the same dass the boolean equais (Object ob j) method must be overriden and implemented by the dass. 

The implementor decides which values must be equal to consider two objects to be equal. For example in the below dass, the name and the address must be equal but not the 

description. 


Code listing 5.5: Customer.java 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 


public dass Customer { 
private String name; 
private String address; 
private String description; 

// . . . 

public boolean equais (Object obj) { 
if (this -- obj) { 
return true; 

} eise if (obj == null) { 
return false; 

} eise if (obj instanceof Customer) { 

Customer cust = (Customer) obj; 

if ((cust. getName () == null && name == null) || 

(cust. getName (). equais (name) && ( (cust. getAddress () 

II cust.getAddress() .equais(address) ) ) { 

return true; 

} 

} 

return false; 

} 


} 


L 


T 


null && address == nu 


After the equais () method is overriden, two objects from the same dass can be compared like this: 


m 


Code section 5.20: Method usage. 

i- 


il Customer custl = new Customer(); 

|2 Customer cust2 = new Customer(); 

'3 //. . . 

■ 

i4 if (custl .equais (cust2)) { 

,5 // Two Customers are equal, by name and address 

'6 } 

I 


L 


J 


Note that equal objects must have equal hash codes. Therefore, when overriding the equais method, you must also override the hashcode method. Failure to do so violates the general 
contract for the hashcode method, and any classes that use the hash code, such as HashMap will not function properly. 

Sorting/Ordering 

In Java, there are several existing methods that already sort objects from any dass like coiiections . sort (List<T> list ). However, Java needs to know the comparison rules between 
two objects. So when you define a new dass and want the objects of your dass to be sortable, you have to implement the comparabie and redefine the compareTo (Object obj ) method. 

int compareTo(T o) 

Compares two objects and return an integer: 

■ A negative integer means that the current object is before the parameter object in the natural ordering. 

■ Zero means that the current object and the parameter object are equal. 

■ A positive integer means that the current object is after the parameter object in the natural ordering. 

Let's say that the name is more important than the address and the description is ignored. 

Code listing 5.6: SortableCustomer.java 


1 public dass SortableCustomer Implements Comparable<SortableCustomer> { 

2 private String name; 

3 private String address; 

4 private String description; 

5 // ... 

6 public int compareTo (SortableCustomer anotherCustomer) { 

7 if (name. compareTo (anotherCustomer. getName ()) == 0) { 

8 return address. compareTo (anotherCustomer. getAddress (); 

9 } eise { 

10 return name. compareTo (anotherCustomer. getName (); 

11 } 

12 } 

13 

14 } 


Objects that implement this interface can be used as keys in a sorted map or elements in a sorted set, without the need to specify a comparator. 

The natural ordering for a dass C is said to be consistent with equais if and only if ei. compareTo ((Object) e2 ) == o has the same boolean value as ei. equais ((Object) e2 ) for every 
el and e2 of dass C. Note that null is not an instance of any dass, and e. compareTo (null) should throw a NullPointerException even though e. equais (null) returns false. 

It is strongly recommended (though not required) that natural orderings be consistent with equais. This is because sorted sets (and sorted maps) without explicit comparators behave 
"strangely" when they are used with elements (or keys) whose natural ordering is inconsistent with equais. In particular, such a sorted set (or sorted map) violates the general contract for set 
(or map), which is defined in terms of the equais method. 

Change Sorting/Ordering 

Sometimes we may want to change the ordering of a collection of objects from the same dass. We may want to order descending or ascending order. We may want to sort by name or by 

address. 


We need to create a dass for each way of ordering. It has to implement the comparator interface. 

Since Java 5.0, the comparator interface is generic; that means when you implement it, you can specify what type of objects your comparator can compare. 
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Code listing 5.7: CustomerComparator.java 

-, 

,1 public dass CustomerComparator Implements Comparator<Customer> {' 
,2 public int compare (Customer custl, Customer cust2) { 1 

i3 return cust1. getName (). compareTo (cust2. getName ()); ‘ 

' 4 } ! 

' 5 > ! 
i_1 


The above dass then can be associated with a SortedSet or other collections that support sorting. 



Code section 5.21: Comparator usage. 



'1 Collection<Customer> orderedCustomers = new TreeSet<Customer> (new CustomerComparator()); i 



Using the Iterator the orderedcustomers collection can be iterated in order of sorted by name. 
A List can be sorted by the Collections' sort method. 

Code section 5.22: Customized comparison. 

i-1 

i i 


■1 java. util . Collections . sort (custList, new CustomerComparator()); i 




Sorts the specified bst according to the order induced by the specified comparator. All elements in the bst must be mutuaby comparable using the specified comparator. 
An array of objects can also be sorted with the help of a comparator. 

Code section 5.23: Array sorting. 

,-| 

' I 

'1 SortableCustomer[] customerArray; i 

i2 //... ; 

3 java. uti1 . Arrays . sort (customerArray, new CustomerComparator() 1 



Sorts the specified array of Customer objects (customerArray) according to the order induced by the specified comparator. All elements in the array must be mutuaby comparable by the 
specified comparator. 


Exceptions 

The ideal time to catch an error is at compile time, before you even try to run the program. However, not all errors can be detected at compile time. The rest of the problems must be 
handled at run time through some formality that abows the originator of the error to pass appropriate information to a recipient who will know how to handle the difficulty properly. 

Improved error recovery is one of the most powerful ways that can increase the robustness of your code. Error recovery is a fundamental concern for every program you write, but it's 
especially important in Java, where one of the primary goals is to create program components for others to use. To create a robust System, each component must be robust. By providing a 
consistent error-reporting model using exceptions, Java allows components to rebably communicate problems to cbent code. 

Flow of code execution 


In Java, there are two main flows of code executions. 

■ Normal main sequential code execution, the program doing what it meant to accomplish. 

■ Exception handling code execution, the main program flow was interrupted by an error or some other condition that prevent the continuation of the normal main sequential code 
execution. 


Exception 

Exceptions are Java's way of error handling. Whenever an unexpected condition occurs, an exception can be thrown with an exception object as a parameter. It means that the normal 
program control flow stops and the search for a catch block begins. If that is not found at the current method level the search continues at the caller method level, until a matching 
catch block is found. If none is found the exception wib be handled by the JVM, and usuaby the java program terminates. 

When a catch "matching" block is found, that block wib be executed, the exception object is passed to the block as a parameter. Then normal program execution continues after the 
catch block. See Java exception handling syntax. 


Exception Object 

This is the object that is "thrown" as a parameter from the error, and passed to the catch block. Exception object encapsulates the information about the error's location and its nature. 
Ab Exception objects must be inherited from the java. lang. Throwabie. See the UML diagram below. 


Figure 6.1: Java exception classes 


Throwabk 


Error 


Exception 


RuntimeException 


java.lang 


Matching rule 
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A thrown exception object can be caught by the catch keyword and specifying the exception object's dass or its super-class. 

Naming Convention 

It is good practice to add Exception to all exception classes. Also the name of the exception should be meaningful, should represent the problem. For example 
customerNotFoundException indicate that customer was not found. 


Throwing and Catching Exceptions 


Language Compilers are adept at pointing out most of the erroneous code in a program, however there are some errors that only become apparent when the program is executed. Consider 
the code listing 6.1; here, the program defines a method divide that does a simple division Operation taking two integers as parameter arguments and returning the result of their division. It 
can safely be assumed that when the divide(4, 2) Statement is called, it would return the number 2. However, consider the next Statement, where the program relies upon the provided 
command line arguments to generate a division Operation. What if the user provides the number zero (0) as the second argument? We all know that division by zero is impossible, but the 
Compiler couldn't possibly have anticipated the user providing zero as an argument. 


Code listing 6.1: SimpleDivisionOperation.java 


1 public dass SimpleDivisionOperation { 

2 public static void raain (String[] args) { 

3 System. out . println (divide(4, 2)); 

4 if (args.length > 1) { 

5 int argO = Integer. parseint (args[0]); 

6 int argl = Integer. parseint (args[1]) ; 

7 System. out . println (divide(argO , argl)); 

8 } 

9 } 

10 

11 public static int divide(int a, int b) { 

12 return a / b; 

13 } 

14 } 



Output for Code listing 6.1 


$ java SimpleDivisionOperation 1 0 
2 

Exception in thread "main" java.lang.ArithmeticException: / by zero 

at SimpleDivisionOperation.divide(SimpleDivisionOperation.java:12) 
at SimpleDivisionOperation.main(SimpleDivisionOperation.java:7) 


Such exceptional code that results in erroneous interpretations at program runtime usually results in errors that are called exceptions in Java. When the Java interpreter encounters an 
exceptional code, it halts execution and displays Information about the error that occurs. This Information is known as a stack trace. The stack trace in the above example teils us more 
about the error, such as the thread — "main" — where the exception occurred, the type of exception — java. lang. ArithmeticException, a comprehensible display message — / by 
zero, and the exact methods and the line numbers where the exception may have occurred. 


Exception object 

The preceding exception could have been created explicitly by the developer as it is the case in the following code: 


Code listing 6.2: SimpleDivisionOperation.java 


1 public dass SimpleDivisionOperation { 

2 public static void main (String[] args) { 

3 System. out . println (divide(4, 2)); 

4 if (args.length > 1) { 

5 // Convert a string to an integer 

6 int argO = Integer. parseint (args[0]); 

7 int argl = Integer.parseint(args[1]); 

8 System. out . println (divide(argO, argl)); 

9 } 

10 } 

11 

12 public static int divide (int a, int b) { 

13 if (b == 0) { 

14 throw new ArithmeticException( "You can\'t divide by zero!"); 

15 } eise { 

16 return a / b; 

17 } 

18 } 

19 } 



Output for Code listing 6.2 


- 

i$ java SimpleDivisionOperation 1 0 1 
',2 1 
lException in thread "main" java.lang.ArithmeticException: You can 1 t divide by zero! 1 
iat SimpleDivisionOperation.divide(SimpleDivisionOperation.java:14) j 
lat SimpleDivisionOperation.main(SimpleDivisionOperation.java:7) j 
L_1 


Note that when b equals zero, there is no return value. Instead of a java. lang. ArithmeticException generated by the Java interpreter itself, it is an exception created by the coder. The 
result is the same. It shows you that an exception is an object. Its main particularity is that it can be thrown. An exception object must inherit from java. lang. Exception. Standard 
exceptions have two constructors: 

1. The default constructor; and, 

2. A constructor taking a string argument so that you can place pertinent information in the exception. 



Code section 6.1: Instance of an exception object with the default constructor. 



>1 new Exception () ; 




Code section 6.2: Instance of an Exception object by passing string in constructor. 



>1 new Exception ("Something unexpected happened"); 



This string can later be extracted using various methods, as you can see in the code listing 6.2. 

You can throw any type of Throwable object using the keyword throw. It interrupts the method. Anything after the throw Statement would not be executed, unless the thrown exception is 
handled. The exception object is not returned from the method, it is thrown from the method. That means that the exception object is not the return value of the method and the calling 
method can be interrupted too and so on and so on... 

Typically, you’ll throw a different dass of exception for each different type of error. The information about the error is represented both inside the exception object and implicitly in the 
name of the exception dass, so someone in the bigger context can figure out what to do with your exception. Often, the only information is the type of exception, and nothing meaningful is 
stored within the exception object. 
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Oracle Standard exception classes 

The box 6.1 below talks about the various exception classes within the java. lang package. 


Box 6.1: The Java exception classes 


Throwable 

The Throwable dass is the superclass of all errors and exceptions in the Java language. Only objects that are instances 
of this dass (or one of its subclasses) are thrown by the Java Virtual Machine or can be thrown by the Java throw 
Statement. 

A throwable contains a snapshot of the execution stack of its thread at the time it was created. It can also contain a 
message string that gives more Information about the error. Finally, it can contain a cause: another throwable that 
caused this throwable to get thrown. The cause facility was added in release 1.4. It is also known as the chained 
exception facility, as the cause can, itself, have a cause, and so on, leading to a "chain" of exceptions, each caused by 
another. 

Error 

An Error indicates serious problems that a reasonable application should not try to handle. Most such errors are 
abnormal conditions. 

Exception 

The dass Exception and its subclasses are a form of Throwable that indicates conditions that a reasonable application 
might want to handle. Also this is the dass that a programmer may want to extend when adding business logic 
exceptions. 

RuntimeException 

RuntimeException is the superclass of those exceptions that can be thrown during the normal Operation of the Java 
Virtual Machine. A method is not required to declare in its throws clause any subclasses of RuntimeException that 
might be thrown during the execution of the method but not caught. 


Figure 6.2: The exception classes and their inheritance 
model in the JCL. 

-1 

I Throwable I 


Error Exception 
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try/catch statement 


By default, when an exception is thrown, the current method is interrupted, the calling method is interrupted too and so on tili the main method. A thrown exception can also be caught using 
a try/catch statement. Below is how a try/catch statement works: 



Code section 6.3: Division into a try block. 

i-, 


1 int a = 4; 

2 int b = 2; 

3 int result = 0; 

4 try { 

5 int c = a / b; 

6 result = c; 

7 } catch (ArithmeticException ex) { 

8 result = 0; 

9 } 

10 return result; 


The executed code lines have been highlighted. When no exception is thrown, the method flow executes the try statement and not the catch statement. 


Code section 6.4: Catching 'division by zero' errors. 


1 int a = 4; 

2 int b = 0; 

3 int result = 0; 

4 try { 

5 int c = a / b; 

6 result = c; 

7 } catch (ArithmeticException ex) { 

8 result = 0; 

9 } 

10 return result; 



As there is a thrown exception at line 5, the line 6 is not executed, but the exception is caught by the catch statement so the catch block is executed. The following code is also executed. 
Note that the catch statement takes an exception as parameter. There is a third case: when the exception is not from the same dass as the parameter: 

^ Code section 6.5: Uncaught exception. 


1 int a = 4; 

2 int b = 0; 

3 int result = 0; 

4 try { 

5 int c = a / b; 

6 result = c; 

7 } catch (NullPointerException ex) { 

8 result = 0; 

9 } 

10 return result; 


It is as if there is no try/catch statement. The exception is thrown to the calling method. 

catch blocks 

A try/catch statement can contain several catch blocks, to handle different exceptions in different ways. Each catch block must take a parameter of a different throwable dass. A thrown 
object may match several catch block but only the first catch block that matches the object will be executed. A catch-block will catch a thrown exception if and only if: 

■ the thrown exception object is the same as the exception object specified by the catch-block. 

■ the thrown exception object is the subtype of the exception object specified by the catch-block. 

This means that the catch block order is important. As a consequence, you can't put a catch block that catches all the exception (which take a java. lang .Exception as parameter) before 
a catch block that catches a more specific exception as the second block could never be executed. 

□ Output for Code section 6.6 




Code section 6.6: Exception handling with catch blocks. 
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i-1 

! 1 try { i 

| 2 // Suppose the code here throws any exceptions, , 

1 3 // then each is handled in a separate catch block. 1 

! 4 ! 

1 5 int[] tooSmallArray = new int [2]; | 

i 6 int outOfBoundsIndex = 10000; 1 

i 7 tooSmallArray[outOfBoundsIndex] = 1; i 

I 8 ! 

i 9 System. out . println ( "No exception thrown.") ; i 

jlO } catch (NullPointerException ex) { , 

'11 System.out. println ( "Except ion handling code for the NullPointerException."); 1 
,12 } catch (NumberFormatException ex) { i 

'13 System.out.printin( "Exception handling code for the NumberFormatException.");, 
il4 } catch (ArithmeticException | IndexOutOfBoundsException ex) { 1 

,15 System. out . println ( "Except ion handling code for ArithmeticException" i 

'16 + " or IndexOutOfBoundsException."); ‘ 

il7 } catch (Exception ex) { i 

18 System.out.printin( "Exception handling code for any other Exception."); , 

; 19 } ; 

l_! 


-, 

I 

Exception handling code for ArithmeticException or IndexOutOfBoundsException. 1 


At line 14, we use a multi-catch clause. It is available since the JDK 7. This is a combination of several catch clauses and let's you handle exceptions in a single handler while also 
maintaining their types. So, instead of being boxed into a parent Exception super-class, they retain their individual types. 

You can also use the java. lang. Throwabie dass here, since Throwable is the parent dass for the application-specific Exception classes. However, this is discouraged in Java 
programming circles. This is because Throwable happens to also be the parent dass for the non-application specific Error classes which are not meant to be handled explicitly as they are 
catered for by the JVM itself. 

f inally block 

A finally block can be added after the catch blocks. A f inally block is always executed, even when no exception is thrown, an exception is thrown and caught, or an exception is 
thrown and not caught. It's a place to put code that should always be executed after an unsafe Operation like a file close or a database disconnection. You can define a try block without 
catch block, however, in this case, it must be followed by a f inally block. 

Example of handling exceptions 

Let's examine the following code: 

A Code section 6.7: Handling exceptions. 

> -, 

i i 

1 1 public void methodA() throws SomeException { i 

i 2 // Method body | 

; 3 } ; 

I 4 I 

i 5 public void methodB() throws CustomException, AnotherException {j 

| 6 // Method body 1 

' 7 } I 

| 8 ; 

1 9 public void methodC() { i 

il 0 methodB () ; | 

jl 1 methodA () ; j 

'12 } ! 


In the code section 6.7, methodc is invalid. Because methodA and methodB pass (or throw) exceptions, methodc must be prepared to handle them. This can be handled in two ways: a 
try-catch block, which will handle the exception within the method and a throws clause which would in turn throw the exception to the caller to handle. The above example will cause a 
Compilation error, as Java is very strict about exception handling. So the programmer is forced to handle any possible error condition at some point. 

A method can do two things with an exception: ask the calling method to handle it by the throws declaration or handle the exception inside the method by the try-catch block. 

To work correctly, the original code can be modified in multiple ways. For example, the following: 

Code section 6.8: Catching and throwing exceptions. 


1 public void methodc () throws CustomException, SomeException 

2 try { 

3 methodB() ; 

4 } catch (AnotherException e) { 

5 // Handle caught exceptions. 

6 } 

7 methodA() ; 

8 } 



The AnotherException from methodB will be handled locally, while CustomExcept ion and someException will be thrown to the caller to handle it. Most of the developers are 
embarrassed when they have to choose between the two options. This type of decision should not be taken at development time. If you are a development team, it should be discussed 
between all the developers in order to have a common exception handling policy. 

Keyword references 

■ try 

■ catch 

■ finally 

■ throws 

■ throw 


Checked Exceptions 

A checked exception is an exception that must be either caught or declared in a method where it can be thrown. For example, the java. io. ioException is a checked exception. To 
understand what is a checked exception, consider the following code: 

A Code section 6.9: Unhandled exception. 

i i 

il public void ioOperation (boolean isResourceAvailable) {i 
|2 if (!isResourceAvailable) { , 

'3 throw new IOException (); 1 
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|4 } 

'5 } 

I 


This code won't compile as it throws or can throw a checked exception without catching it or declare it. Two different modifications can resolve the Situation: to catching it or to declare it 
by the throws keyword. 



Code section 6.10: Catching an exception. 

i-, 


1 public void ioOperation(boolean isResourceAvailable) { 

2 try { 

3 if (!isResourceAvailable) { 

4 throw new IOException(); 

5 } 

6 } catch (IOException e) { 

7 // Handle caught exceptions . 

8 } 

9 } 


Code section 6.11: Declaring an exception. 

■ l 
jl public void ioOperation (boolean isResourceAvailable) throws IOException 
'2 if ((isResourceAvailable) { 
i3 throw new IOException () ; 

|4 } 

'5 } 

I 


In the Java dass hierarchy, an exception is a checked exception if it inherits from java. lang .Exception, but not from java. lang .RuntimeException. All the application or business 
logic exceptions should be checked exceptions. 

It is possible that a method declares that it can throw an exception, but actually it does not. Still, the caller has to deal with it. The checked exception declaration has a domino effect. Any 
methods that will use the previous method will also have to handle the checked exception, and so on. 

So the Compiler for the Java programming language checks, at compile time, that a program contains handlers for all application exceptions, by analyzing each method body. If, by executing 
the method body, an exception can be thrown to the caller, that exception must be declared. How does the Compiler know whether a method body can throw an exception? That is easy. 
Inside the method body, there are calls to other methods; the Compiler looks at each of their method signature, what exceptions they declared to throw. 

Why Force Exception Handling? 

This may look boring to the developer but it forces them to think about all the checked exceptions and increase the code quality. This compile-time checking for the presence of exception 
handlers is designed to make the application developer life easier. To debug whether a particular thrown exception has a matching catch would be a long process. In conventional languages 
like C, and C++, a separate error handling debugging were needed. In java we can be sure that when an application exception is thrown, that exception somewhere in the program is 
handled. In C, and C++, that has to be tested. In Java that does not need to be tested, so the freed up time can be used for more meaningful testing, testing the business features. 

What Exceptions can be Declared when Overriding a Method? 

The checked exception classes specified after the throws keyword are part of the contract between the implementer and user. An overriding method can declare the same exceptions, 
subclasses or no exceptions. 

What Exceptions can be Declared when Implementing an Interface? 

When interfaces are involved, the implementation declaration must have a throws-clause that is compatible with the interface declarations. 


Unchecked Exceptions 

Unchecked, uncaught or runtime exceptions are exceptions that are not required to be caught or declared, even if it is allowed to do so. So a method can throw a runtime exception, even if 
this method is not supposed to throw exceptions. For example, concurrentModif icationException is an unchecked exception. 

The unchecked exceptions can only be the RuntimeException and its subclasses, and the dass Error and its subclasses. All other exception classes must be handled, otherwise the 
Compiler gives an error. 

Sometime it is desirable to catch all exception for logging purposes, then throw it back on. For example, in servlet programming when application Server calls the Server doPost (), we want 
to monitor that no exception even runtime exception happened during serving the request. The application has its own logging separate from the Server logging. The runtime exceptions 
would just go through without detecting it by the application. The following code would check all exceptions, log them, and throw it back again. 

Code section 6.12: Declaring an exception. 


1 public void doPost (HttpReguest request, HttpResponse response 

2 try { 

3 

4 handleRequest(); 

5 

6 } catch (Exception e) { 

7 log. error ( "Error during handling post request", e); 

8 

9 throw e; 

10 } 

11 } 


In the above code, all business logic exception are handled in the handleRequest () method. Runtime exceptions are caught for logging purposes, and then thrown back to the Server to 
handle it. 

Runtime exceptions are usually caused by data errors, like arithmetic overflow, divide by zero, ... . Runtime exceptions are not business related exceptions. In a well debugged code, runtime 
exceptions should not occur. Runtime exceptions should only be used in the case that the exception could be thrown by and only by something hard-coded into the program. These should 
not be able to be triggered by the software's user(s). 


Preventing NullPointerException 

Nu liPo int er Exception is a RuntimeException. In Java, a special null can be assigned to an object reference. NullPointerException is thrown when an application attempts to use an 
object reference, having the null value. These include: 

■ Calling an instance method on the object referred by a null reference. 
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■ Accessing or modifying an instance field of the object referred by a null reference. 

■ If the reference type is an array type, taking the length of a null reference. 

■ If the reference type is an array type, accessing or modifying the slots of a null reference. 

■ If the reference type is a subtype of Throwabie, throwing a null reference. 

Applications should throw instances of this dass to indicate other illegal uses of the null object. 



Code section 6.13: Null pointer. 


1 


il Object obj = null; 

2 obj.t oStr ing () ; // This Statement will throw a NullPointerExcepti 

L_ 


The above code shows one of the pitfall of Java, and the most common source of bugs. No object is created and the Compiler does not detect it. NuiiPointerException is one of the most 
common exceptions thrown in Java. 

Why do we need null? 

The reason we need it is because many times, we need to create an object reference before the object itself is created. Object references cannot exist without a value, so we assign the null 
value to it. 

Code section 6.14: Non-instantiated declared object. 

i-n 

i i 

il public Person getPerson (boolean isWoman) { i 

,2 Person person = null; J 

|3 if (isWoman) { 1 

i4 person = createWoraan () ; i 

|5 } eise { | 

'6 person = createMan () ; ' 

■ I 

i7 } 

|8 return person; ■ 

19 } 1 

1 1 

L_I 



In the code section 6.14 we want to create the Person inside the if-else, but we also want to return the object reference to the caller, so we need to create the object reference outside of the 
if-else, because of the scoping rule in Java. Incorrect error-handling and poor contract design can be a pitfall with any programming language. This is also true for Java. 

Now we will describe how to prevent NuiiPointerException. It does not describe general techniques for how you should program Java. It is of some use, to make you more aware of null 
value s, and to be more careful about generating them yourself. 

This list is not complete — there are no rules for preventing NuiiPointerException entirely in Java, because the Standard libraries have to be used, and they can cause 

Nu iipo int er Exceptions. Also, it is possible to observe an uninitialized final field in Java, so you can't even treat a final field as being completely trusted during the object's creation. 

A good approach is to leam how to deal with NuiiPointerExceptions first, and become competent with that. These suggestions will help you to cause less NuiiPointerExceptions, but 
they don't replace the need to know about NuiiPointerExceptions. 

Comparing string variable with a string literal 

When you compare a variable with a string literal, most of people would do that this way: 

Code section 6.15: Bad comparison. 


1 if (state. equals ( "OK" )) { 

2 

3 } 



Always put the string literal first: 

Q Code section 6.16: Better comparison. 

i I 

11 if ( "OK" . equals (state) ) { i 

1 2 ! 

• • • i 

> 3 } ; 

i i 


If the state variable is null, you get a NuiiPointerException in the first example, but not in the second one. 


Minimize the use of the keyword 'null' in assignment Statements 

This means not doing things like: 

^ Code section 6.17: Declaring an exception. 


1 String s = null; 

2 while (something) { 

3 if (something2) { 

4 s = "yep"; 

5 } 

6 } 

7 

8 if (s != null) { 

9 something3 (s); 

10 } 


You can replace this with: 

Q Code section 6.18: Declaring an exception. 


1 boolean done = false; 

2 

3 while (!done && something) { 

4 if (something2) { 

5 done - true; 

6 something3 ( "yep" ); 

7 } 
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You might also consider replacing null with "" in the first example, but default values bring about bugs caused by default values being left in place. A NuiiPointerException is actually 
better, as it allows the runtime to teil you about the bug, rather than just continue with a default value. 

Minimize the use of the new Type[int] syntax for creating arrays of objects 

An array created using new Object [ 10 ] has 10 null pointers. That's 10 more than we want, so use collections instead, or explicitly fill the array at initialization with: 




Code section 6.19: Declaring an exception. 



or: 


S 


Code section 6.20: Declaring an exception. 


,1 Object [] objects; 

'2 objects = new Object[] { "bläh" , 5, new File ( "/usr/bin" ) } ; 


Check all references obtained from 'untrusted' methods 

Many methods that can return a reference can return a null reference. Make sure you check these. For example: 

Code section 6.21: Declaring an exception. 


jl File file = new File ( "/etc" ); 

'2 File[] files = file . listFiles () ; 
i3 if (files != null) { 

|4 stuff 

'5 } 

I 


File .listFiles () can return null if /etc is not a directory. 

You can decide to trust some methods not to return null, if you like, but that's an assumption you're making. Some methods that don't specify that they might return null, actually do, instead 
of throwing an exception. 

For each loop trap 

Beware if you loop on an array or a collection in a for each loop. 

Code section 6.22: Visit a collection. 


'1 Collection<Integer> rayNurabers = buildNumbers(); 
i2 for (Integer rayNuraber : rayNumbers) { 

|3 System.out. printin (rayNuraber); 

'4 } 

i 



If the object is null, it does not just do zero loops, it throws a null pointer exception. So don't forget this case. Add an if Statement or return empty collections: 

Code section 6.23: Visit a collection safety. 


'1 Collection<Integer> rayNurabers = buildNumbers(); 
i2 if (myNumbers != null) { 

|3 for (Integer myNumber : myNumbers) { 

'4 System.out. printin (myNumber); 

i5 } 

|6 * 

I 



External tools 

There is tools like FindBugs that parse your code and warn you about potential bugs. Most of the time, it detects possible null pointers. 


Stack trace 


Stack Trace is a list of method calls from the point when the application was started to the point where the exception was thrown. The most recent method calls are at the top. 

Code listing 6.3: StackTraceExample.java □ 

,-1 

' i 

' 1 public dass StackTraceExample { 1 

| 2 public static void main (String[] args) { 1 

| 3 methodl(); j 

I 4 } | 

| 5 | 

i 6 public static void methodl () { [ 

! 7 methodl1(); j 

Is} ; 

! 9 I 

I I 

ilO public static void methodllf) { , 

' i 

il 1 methodl 11 () ; i 


Output for Code listing 6.3 

-1 

Exception in thread "main" java.lang.NuiiPointerException: Fictitious NuiiPointerException 1 
at StackTraceExample.methodl11(StackTraceExample.java:15) 1 

at StackTraceExample.methodl1(StackTraceExample.java:11) ’ 

at StackTraceExample.methodl(StackTraceExample.java:7) ) 

at StackTraceExample.main(StackTraceExample.java:3) " 

l_1 
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12 } 

13 

14 public static void methodlll() { 

15 throw new NullPointerException( "Fictitious NullPointerException 

16 } 

17 } 


The stack trace can be printed to the Standard error by calling the public void printstackTrace () method of an exception. 


From Java 1.4, the stack trace is encapsulated into an array of a java dass called java. lang. stackTraceEiement. The stack trace element array returned by 

Throwabie. getstackTrace () method. Each element represents a single stack frame. All stack frames except for the one at the top of the stack represent a method invocation. The frame 
at the top of the stack represents the execution point at which the stack trace was generated. Typically, this is the point at which the throwabie corresponding to the stack trace was created. 

A stack frame represents the following Information: 



Code section 6.24: Stack frame. 


'1 public StackTraceEiement (String declaringClass, 
i2 String methodName, 

|3 String fileName, 

'4 int lineNumber) ; 

■ 


Creates a stack trace element representing the specified execution point. 

Converting the stack trace into string 

Many times for debugging purposes, we'd like to convert the stack trace to a string so we can log it to our log file. 
The following code shows how to do that: 

Code section 6.25: Save the stack trace. 


1 import java.io.StringWriter ; i 

2 import java.io.PrintWriter ; , 

3 ! 

5 | 

6 Exception e = new NullPointerException (); 1 

7 ! 

8 StringWriter outError = new StringWriter(); ' 

9 e. printstackTrace (new PrintWriter(outError)) ■ 

10 String errorString = outError. toString (); , 

11 1 

12 // Do whatever you want with the errorStringt 


Nesting Exceptions 


When an exception is caught, the exception contains the stack-trace, which describes the error and shows where the exception happened, where the problem is, where the application 
programmer should look to fix the problem. Sometime it is desirable to catch an exception and throw another new exception. If the new exception keep a reference to the first exception, the 
first exception is called a nesting exception. 


Code listing 6.4: NestingExceptionExample.java 


- n 

1 public dass NestingExceptionExample { 1 

2 1 

3 public static void main (String[] args) throws Exception {' 

4 Object[] localArgs = (Object[]) args; ' 

5 | 

6 try { | 

7 Integer[] numbers = (Integer[]) localArgs; , 

8 } catch (ClassCastException originalException) { , 

9 Exception generalException = new Exception( , 

10 "Horrible exception!", , 

11 originalException); i 

12 throw generalException; i 

13 } ! 

14 } ! 

15 } ! 



Output for Code listing 6.4 


[Exception in thread "main" java.lang.Exception: Horrible exception! 

i 

iat NestingExceptionExample.main(NestingExceptionExample.java:9) 

1 

iCaused by: java.lang.ClassCastException: [Ljava.lang.String; incompatible with [Ljava.lang.Integer; 

i 

iat NestingExceptionExample.main(NestingExceptionExample.java:7) 

i 

I_ 


The above code is an example of a nesting exception. When the Exception is thrown, by passing in the ClassCastException object reference as a parameter, the ClassCastException is 
nested in the newly created Exception, its stack-trace is appended together. When the Exception is caught, its stack-trace contains the original ciassCastException's stack-trace. 

This is a kind of exception conversion, from one exception to another. For example, calling a remote object using RMI, the calling method has to deal with RemoteException which is 
thrown if something is wrong during the communication. For the application point of view, RemoteException has no meaning, it should be transparent to the application that a remote object 
was used or not. So the RemoteException should be converted to an application exception. 

This conversion can also hide where the error is originated. The stack-trace Starts when the exception is thrown. So when we catch and throw a new exception, the stack-trace Starts at when 
the new exception was thrown, losing the original stack-trace. This was true with the earlier Version of Java (before 1.4). Since then, a so called cause facility capabilities were built in the 
Throwabie dass. 


A throwabie contains a snapshot of the execution stack of its thread at the time it was created. It can also contain a message string that gives more information about the error. Finally, it can 
contain a cause: another throwabie that caused this throwabie to get thrown. The cause facility is also known as the chained exception facility, as the cause can, itself, have a cause, and so 
on, leading to a "chain" of exceptions, each caused by another. 

A cause can be associated with a throwabie in two ways: via a constructor that takes the cause as an argument, or via the initcause (Throwabie) method. New throwabie classes that wish 
to allow causes to be associated with them should provide constructors that take a cause and delegate (perhaps indirectly) to one of the Throwabie constructors that takes a cause. For 
example: 
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^ Code section 6.26: Chaining-aware constructor. 

i- ] 

!l try { ! 

'2 lowLevelOp () ; | 

i3 } catch (LowLevelException le) { 1 

[4 throw new HighLevelException (le); 1 

'5 } ; 

1 

L_I 


Because the initCause method is public, it allows a cause to be associated with any throwable, even a "legacy throwable" whose implementation predates the addition of the exception 
chaining mechanism to Throwable. For example: 



Code section 6.27: Legacy constructor. 


!l try { 

|2 lowLevelOp () ; 

i3 } catch (LowLevelException le) { 

,4 throw (HighLevelException) new HighLevelException(). initCause (le 

'5 } 

I 


Further, as of release 1.4, many general purpose Throwable classes (for example Exception, RuntimeException, Error) have been retrofitted with constructors that take a cause. This was 
not strictly necessary, due to the existence of the initCause method, but it is more convenient and expressive to delegate to a constructor that takes a cause. 

By convention, dass Throwable and its subclasses have two constructors, one that takes no arguments and one that takes a String argument that can be used to produce a detail message. 
Further, those subclasses that might likely have a cause associated with them should have two more constructors, one that takes a Throwable (the cause), and one that takes a String (the 
detail message) and a Throwable (the cause). 


Concurrent Programming 

In Computer programming, an application program runs in a certain process of the CPU. Every Statement that is then executed within the program is actually being executed in that process. 
In essence, when a Statement is being executed, the CPU focuses all its attention on that particular Statement and for the tiniest fraction of a second puts everything eise on hold. After 
executing that Statement, the CPU executes the next Statement and so forth. 

But consider for a moment that the execution of a particular Statement is expected to take a considerable amount of time. You do not want to keep the CPU on halt until the Statement gets 
executed and done with; you would want the CPU to continue with some other application process and resume the current application as smoothly as possible after its Statement is executed. 
It can only be possible if you can run several processes simultaneously, such that when one process is executing a Statement that is expected to take some time, another process in the queue 
would continue doing other things and so on. Such a principle of programming is called concurrent programming. 

Throughout this chapter, we will be taking a look at concurrent programming constructs present in the Java programming language. 


Threads and Runnables 

CPUs for any Computer are designed to execute one task at any given time, yet we run multiple applications side-by-side and everything works in perfect congruence. It's not just because 
CPUs are extremely fast in performing calculations, it's because CPUs use a clever device of dividing their time amongst various tasks. Each application or task that is invoked on a 
Computer gets associated with the CPU in the form of a process. A CPU therefore manages various processes, and jumps back and forth amongst each process giving it a fraction of its time 
and processing capability. This happens so fast that to a normal Computer user it presents with the illusion of processes being run simultaneously. This capability of the CPU to divide its time 
amongst processes is called multitasking. 

So, if we run a Java application on a Computer, we are effectively creating a process with the CPU that gets a fraction of the CPUs time. In Java parlance, this main process gets called the 
daemon process or the daemon thread. But, Java goes one Step further. It allows programmers to divide this daemon thread into several multiple threads which get executed simultaneously 
(much like a CPU) hence providing a Java application with a finer multitasking capability called multithreading. 

In this section, we will take a look at what threads are and how multithreading is implemented within a Java program to make it appear congruent and effectively fast to respond. 

Threads 

In light of the above discussion, a thread is the smallest unit of processing that can be scheduled by an operating System. Therefore, using threads, a programmer can effectively create two 
or more tasks^ that run at the same time. The first call-to-action is to implement a set of tasks that a particular thread would execute. To do so, we require the creation of a Runnabie 
process. 

Creating a Runnabie process block 

A Runnabie process block is a simple dass that implements a run () method. Within the run () method is the actual task that needs to be executed by a running thread. By implementing a 
dass with the Runnabie (http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Runnable.html) interface, we ensure that the dass holds a run () method. Consider the following 
program: 

Code listing 1: A runnabie process 


Import java.util.Random; 

public dass RunnableProcess implements Runnabie { 
private String name; 
private int time; 

private Random rand = new Random(); 

public RunnableProcess (String name) { 
this .name = name; 
this . time = rand. nextInt (999); 

} 

public void run () { 

try { 

System. out . printf (" %s is sleeping for %d \n", this. name, this. time); 
Thread. sleep (this. time) ; 

System. out . printf (" %s is done.Xn", this. name); 
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} catch (Exception ex) { 

ex.printStackTrace (); 

} 

} 

} 


In the above code, we create a dass called RunnabieProcess and implement the Runnabie interface to ensure that we have a run () method in the dass declaration. 

Code section 1.1: Implementing the Runnabie interface 

I-1 

i i 

ipublic dass RunnabieProcess implements Runnabie { i 

i i 

1 public void run () { 1 

! } ! 

■} ■ 

i i 

i_i 


We then declare the rest of the logic for the dass. For the constructor, we take a string parameter that would serve as the name of the dass. Then, we initialize the dass member variable 
time with a randomnumber between o and 9 9 9. To ensure the initialization of a random number, we use the Random dass in the java. utii package. 

Code section 1.2: Including ability to generate random integers between o and 999 

! ' 

,import java.util.Random; i 

- ! 

iprivate Random rand = new Random(); 1 

i j 

'this rand. nextInt ( 999); ! 



The actual task that would be executed per this runnabie block is presented within the run () method. To keep safe from exceptions occurring because of the concurrent programming, we 
wrap the code within this method with a try. . catch block. The executing task actually consists of just three Statements. The first Outputs the provided name for the Runnabie process, and 
the last reports that the thread has executed. Perhaps the most intriguing part of the code is the second Statement: Thread. sieep (...). 



Code section 1.3: The actual runnabie process task 

;-i 


'System.out. printf ("%s is sleeping for %d \n", this. name, this. time); 
iThread. sieep (this . time) ; 

jSystem. out . printf ( "%s is done \n", this. name); 

L_ 


This Statement allows the thread executing the current runnabie block to halt its execution for the given amount of time. This time is presented in milliseconds. But for our convenience, this 
time would be the random number generated in the constructor and can be anywhere between o and 999 milliseconds. We will explore this in a later section. Creating a Runnabie process 
block is just the beginning. No code is actually executed. To do so, we would require the creation of threads that would then individually execute this task. 

Creating threads 

Once we have a Runnabie process block, we can create various threads that can then execute the logic encased within such blocks. Multithreading capabilities in Java are utilized and 
manipulated using the Thread (http://download.oracle.eom/javase/l.5.0/docs/api/java/lang/Thread.html) dass. A Thread object therefore holds all the necessary logic and devices to create 
truly multithreaded programs. Consider the following program: 

Code listing 2: Creating Thread objects 


public dass ThreadLogic { 

public static void main (String[] args) { 

Thread tl = new Thread (new RunnabieProcess( "Thread-1 ")) ; 
Thread t2 = new Thread (new RunnabieProcess( "Thread-2 ")) ; 
Thread t3 = new Thread (new RunnabieProcess ("Thread-3 ")) ; 

} 

} 


Creating threads is as simple as the above program suggests. You just have to create an object of the Thread dass and pass a reference to a Runnabie process object. In the case above, we 
present the Thread constructor with the dass object for the RunnabieProcess dass that we created in code listing 1. But for each object, we give a different name (i.e., "Thread-i " and 
"Thread-2 ", etc.) to differentiate between the three Thread objects. The above example only declares Thread objects and hasn't yet started them for execution. 

Starting threads 

Now, that we know how to effectively create a Runnabie process block and a Thread object that executes it, we need to understand how to Start the created Thread objects. This couldn't 
be simpler. For this process, we will be calling the start () method on the Thread objects and voilä, our threads will begin executing their individual process tasks. 

Code listing 3: Starting the Thread objects 


public dass ThreadLogic { 

public static void main (String[] args) { 

Thread tl = new Thread (new RunnabieProcess( "Thread-1 ")) ; 
Thread t2 = new Thread (new RunnabieProcess( "Thread-2 ")) ; 
Thread t3 = new Thread (new RunnabieProcess (" Thread-3 ")) ; 

tl. Start (); 
t2. Start (); 
t3. Start (); 

} 

} 


The above code will Start all three declared threads. This way, all three threads will begin their execution one-by-one. However, this being concurrent programming and us having declared 
random times for the halting of the execution, the Outputs for every one of us would differ. Following is the output we received when we executed the above program. 

Output for code listing 3 


Thread-l is sleeping for 419 
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jThread-3 

is 

sleeping 

for 

876 


jThread-2 

is 

sleeping 

for 

189 


iThread-2 

is 

done 




iThread-1 

is 

done 




iThread-3 

is 

done 




1 - 





- - 


It should be noted that the execution of the Thread didn't occur in the desired order. Instead of the order ti-t2-t3, the threads executed in the order of ti-t3-t2. The order in which the 
threads are executed is completely dependant on the operating System and may change for every execution of the program, thus making output of multithreaded application difficult to 
predict and control. Some people suggest that this is the major reason that adds to the complexity of multithreaded programming and its debugging. However, it should be observed that once 
the threads were put to sleep using the Thread. sieep (...) function, the execution intervals and order can be predicted quite capably. The thread with the least amount of sleeping time 
was 12 ("Thread- 2 ") with 18 9 milliseconds of sleep hence it got called first. Then ti was called and finally t3 was called. 

Manipulating threads 

It can be said that the execution order of the threads was manipulated to some degree using the Thread. sleep (...) method. The Thread dass has such static methods that can arguably 
affect the execution order and manipulation of threads. Below are some useful static methods in the Thread dass. These methods when called will only affect the currently running threads. 


Method 

Description 

Thread.currentThread() 

Returns the currently executing thread at any given time. 

Thread.dumpStack() 

Prints a stack trace of the currently running thread. 

Thread.sleep(long millis) 

Halts execution of the currently running thread for the given amount of time (in milliseconds). 

thrOWS InterruptedException 

Thread.sleep(long millis, int nanos) 

Halts execution of the currently running thread for the given amount of time (in milliseconds plus provided nanoseconds). 

thrOWS InterruptedException 

Thread.yield() 

Temporarily pauses the execution of the currently running thread to allow other threads to execute. 


Synchronization 

Given below is an example of creating and running multiple threads that behave in a synchronous manner such that when one thread is using a particular resource, the others wait until the 
resource has been released. We will talk more about this in later sections. 

Code listing 4: Creation of the multiple Thread objects running synchronously 


public dass MultiThreadExample { 
public static boolean cthread; 

public static String stuft - " printing material"; 

public static void main (String args[]) { 

Thread tl = new Thread (new RunnableProcess()); 

Thread t2 = new Thread (new RunnableProcess ()); 
tl. setName ( " Thread-1 " ); 
t2. setName ( "Thread-2 " ); 
t2. Start (); 
tl. Start (); 

} 

/* 

* Prints Information about the current thread and the index it is 

* on within the RunnableProcess 
*/ 

public static void printFor(int index) { 

StringBuffer sb = new StringBuffer (); 

sb. append (Thread.currentThreadO . getName ()) .append ( stuff); 
sb.append(" for the "). append (index). append ( " time."); 

System .out. print (sb.toStringO ) ; 

} 

} 

dass RunnableProcess Implements Runnable { 
public void run () { 

for (int i = 0; i < 10; £++) { 

synchronized (MultiThreadExample. stuff ) { 

MultiThreadExample .printFor (i); 
try { 

MultiThreadExample .stuff.noti fyAl1 () ; 
MultiThreadExample. stuff . wait (); 

} catch (InterruptedException ex) { 
ex.printStackTrace (); 

} 

} 

} 

} 

} 


Output for code listing 4 


iThread-l 

printing 

material 

for 

the 

0 

time.' 

iThread-2 

printing 

material 

for 

the 

0 

time.' 

iThread-1 

printing 

material 

for 

the 

1 

time.' 

iThread-2 

printing 

material 

for 

the 

1 

time.j 

iThread-1 

printing 

material 

for 

the 

2 

time.j 

'Thread-2 

| 

printing 

material 

for 

the 

2 

t ime . 

'Thread-l 

1 

printing 

material 

for 

the 

3 

t ime. | 

'Thread-2 

■ 

printing 

material 

for 

the 

3 

time. | 

'Thread-l 

■ 

printing 

material 

for 

the 

4 

time. i 

'Thread-2 

■ 

printing 

material 

for 

the 

4 

time. i 

jThread-1 

printing 

material 

for 

the 

5 

time. i 

jThread-2 

printing 

material 

for 

the 

5 

time. i 

jThread-1 

printing 

material 

for 

the 

6 

time. i 

jThread-2 

printing 

material 

for 

the 

6 

time.' 

jThread-1 

printing 

material 

for 

the 

7 

time.' 

jThread-2 

printing 

material 

for 

the 

7 

time.' 

jThread-1 

printing 

material 

for 

the 

8 

time.' 

iThread-2 

printing 

material 

for 

the 

8 

time.' 

iThread-1 

printing 

material 

for 

the 

9 

time.' 

iThread-2 

■ 

printing 

material 

for 

the 

9 

time.' 
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Where are threads used? 

Threads are used intensively in applications that require a considerable amount of CPU usage. For operations that are time-consuming and intensive, 
it is usually advised to use threads. A example of such an application would be a typical video game. At any given time, a video game involves 
various characters, objects in the surroundings and other such nuances that needs to be dealt with simultaneously. Dealing with each element or 
object within the game requires a fair amount of threads to monitor every object. 

For example, take this screen-shot of a role-playing strategy game on the right. Here the game visuals depict various in-game characters moving about 
on the screen. Now imagine processing the movements, direction and behaviors of each of the characters visible on screen. It would certainly take a 
lot of time moving each character one-by-one if this were to be done one task after another. However if fundamentals of multi-threading are 
employed, each character would move in a synchronous manner with respect to others. 

Threads are not only used heavily in video games, their use is common in everything from simple browser applications to complex operating Systems 
and networking applications. Today it often goes beyond the simple preference of the developer but into the need to maximize the usefulness of 
contemporaneous hardware that is predicated in heavy multitasking. 

References 

1. The number of tasks that can be run simultaneously for a single Java application depends on how many tasks an operating System allows to be multithreaded. 
Daemon thread tutorial (http://www.javaexperience.com/daemon-threads-in-java-with-example-code) 



Basic Synchronization 


In a multi-threaded environment, when more than one thread can access and modify a resource, the outcome could be unpredictable. For example, let's have a counter variable that is 
incremented by more than one thread. 

Beware! Synchronization is an ambiguous term. It doesn't consist of making all threads executing the same code section at the same time. It is the opposite. It prevents any two threads from 
executing the same code section at the same time. It synchronizes the end of one processing with the beginning of a second processing. 

JjjjP Code section 1.1: Counter implementation 

- - , 

i i 

iint counter = 0; i 

i i 

■counter += 1; 1 


The above code is built up by the following sub-operations: 

■ Read ; read variable counter 

■ Add ; add 1 to the value 

■ Save ; save the new value to variable counter 

Let’s say that two threads need to execute that code, and if the initial value of the counter variable is zero, we expect after the operations the value to be 2. 



In the above case Thread 1 Operation is lost, because Thread 2 overwrites its value. We'd like Thread 2 to wait until Thread 1 finishes the Operation. See below: 


Thread 1 


Thread 2 


Read 0 



Add 1 



Save 1 




blocked 

blocked 


unblocked 


Read 1 



Add 1 



Save 

2 


Critical Section 

In the above example the code counter+=i must be executed by one and only one thread at any given time. That is called critical section. Düring programming, in a multi-threading 
environment we have to identify all those pieces of code that belongs to a critical section, and make sure that only one thread can execute those codes at any given time. That is called 
synchronization. 


Synchronizing threads 

The thread access to a critical section code must be synchronized among the threads, that is to make sure that only one thread can execute it at any given time. 


Object monitor 

Each object has an Object monitor. Basically it is a semaphore, indicating if a critical section code is being executed by a thread or not. Before a critical section can be executed, the 
thread must obtain an Object monitor. Only one thread at a time can own that object’s monitor. 


A thread becomes the owner of the object’s monitor in one of three ways 
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■ By executing a synchronized instance method of that object. See synchronized keyword. 

■ By executing the body of a synchronized Statement that synchronizes on the object. See synchronized keyword. 

■ For objects of type Class, by executing a synchronized static method of that dass. 

The Object Monitor takes care of the synchronization, so why do we need the "wait() and notifyO methods"? 

For synchronization we don't really need them, however for certain situations it is nice to use them. A nice and considerate thread will use them. It can happen that during executing a 
critical section, the thread is stuck, cannot continue. It can be because it's waiting for an IO and other resources. In any case, the thread may need to wait a relatively long time. It 
would be selfish for the thread to hold on to the object monitor and blocking other threads to do their work. So the thread goes to a 'wait' state, by calling the wait () method on the 
object. It has to be the same object the thread obtained its object monitor from. 

On the other hand though, a thread should call the wait () method only if there is at least one other thread out there who will call the not if y () method when the resource is 
available, otherwise the thread will wait for ever, unless a time interval is specified as parameter. 

Let's have an analogy. You go in a shop to buy some items. You line up at the counter, you obtain the attention of the sales-clerk - you get her "object-monitor". You ask for the item 
you want. One item needs to be brought in from a warehouse. It'll take more than five minutes, so you release the sales-clerk (give her back her "object-monitor") so she can serve 
other customers. You go into a wait state. Let's say there are five other customers already waiting. There is another sales-clerk, who brings in the items from the warehouse. As she 
does that, she gets the attention of the first sales-clerk, getting her object-monitor and notifies one or all waiting customer(s), so the waited customer(s) wake up and line up again to 
get the attention of the first sales-clerk. 

Note the synchronization between the waiting customer and the sales-clerk who brings in the items. This is kind of producer-consumer synchronization. 

Also note that there is only one object-monitor, belonging to the first sales-clerk. That object-monitor/the attention of clerk needs to be obtained first before a wait and a notify can 
happen. 


final void wait() method 

The current thread must own this object's monitor. The thread releases ownership of this monitor and waits until another thread notifies the threads waiting on this object's monitor to 
wake up either through a call to the notify method or to the notifyAii method. The thread then waits until it can re-obtain ownership of the monitor and resume execution. 


final void wait(long time) 

The same as wait, but the thread wakes after the specified duration of time passes, regardless of whether there was a notification or not. 


final void notifyO 

This method should only be called by a thread that is the owner of this object's monitor. Wakes up a single thread that is waiting on this object's monitor. If many threads are waiting on 
this object's monitor, one of them is chosen to be awakened. The choice is arbitrary and occurs at the discretion of the implementation. A thread waits on an object's monitor by calling 
one of the wait methods. 

The awakened thread will not be able to proceed until the current thread relinquishes the lock on this object. The awakened thread will compete in the usual manner with any other 
threads that might be actively competing to synchronize on this object; for example, the awakened thread enjoys no reliable privilege or disadvantage in being the next thread to lock 
this object. 


final void notifyAii() 

Same as notify (), but it wakes up all threads that are waiting on this object's monitor. 


What are the differences between the sleep() and wait() methods? 


Thread.sleep(millis) 

This is a static method of the Thread class. Causes the currently executing thread to sleep (temporarily cease execution) for the specified number of milliseconds. The thread 
does not lose ownership of any monitors. It means that if the thread has an object-monitor, all other threads that need that monitor are blocked. This method can be called 
regardless whether the thread has any monitor or not. 

wait() 

This method is inherited from the object class. The thread must have obtained the object-monitor of that object first before calling the wait() method. The object monitor is 
released by the waitQ method, so it does not block other waiting threads wanting this object-monitor. 


Client Server 


In 1990s, the trend was moving away from Mainframe computing to Client/Server, as the price of Unix Servers dropped. The database access and some business logic were centralized on 
the back-end Server, collecting data from the user program was installed on the front-end users' "client" Computers. In the Java world there are three main ways the front-end and the 
back-end could simply communicate. 

■ The client application using JDBC to connect the data base Server, (Limited business logic on the back-end, unless using Stored procedures) 

■ The client application using RMI (Remote Method Invocation) to communicate with the back-end. 

■ The client application using socket connection to communicate with the back-end. 

Socket Connection Example 

In this page there is an example for socket connection. 

Create a Server 

Java language was developed having network computing in mind. For this reason it is very easy to create a Server program. A Server is a piece of code that runs all the time listening on a 
particular port on the Computer for incoming request. When a request arrives, it Starts a new thread to Service the request. See the following example: 
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G comClient 

• getSei verData ( ) 

• openCom ( ) 

• sendDataToServer ( ) 

• closeCom ( ) 



G java.lang.Thread 


Ä run ( ) 


G ComProtocol 




• pocesslnput ( ) 

G ComServerThread 


uses 

d tDataFiomClient : COM_DA... 



q clientSocket 


9 1 

n tDataToClient : COM_DATA 

G COM_DATA 

| o comData 



C°rri_ ta _ romserveithrea<fr getDataFi omClient ( ) 



# sendDataToClient ( ) 


Figure 1: Simple Client Server Implementation 


Listening on a port 
ComServer 

dass is for listening on a port for a dient. 

Code listing 1.1: ComServer 


Import java.net.ServerSocket ; 

/* * 

* — Main Server dass; Listening on a port for dient; If there is a dient, 

* Starts a new Thread and goes back to listening for further dients. — 

*/ 

public dass ComServer 

{ 

static boolean GL_listening = true; 

/ * * 

* — Main program to Start the Server — 

*/ 

public static void main (String[] args) throws IOException 

{ 

ComServer srv = new ComServer (); 
srv. listen (); 

} // - End of Main Method - 

/ ** 

* — Server method; Listen for dient — 

*/ 

public int listen () throws IOException 

{ 

ServerSocket serverSocket = null; 
int iPortNumber = 9090; 

// - Open the Server Socket where this should listen - 

try { 

System. out . println ( "*** Open the listening socket; at:"+ iPortNumber + " ***" ); 
serverSocket = new ServerSocket ( iPortNumber ); 

} catch (IOException e) { 

System. err . println (" Could not listen on port : "liPortNumber ); 

System. exit (1); 

} 

while ( GL_listening ) 

{ 

ComServerThread clientServ; 

//- Listening for dient; If there is a dient Start a Thread - 

System. out . println ( "*** Listen for a Client; at:"+ iPortNumber + " ***" ); 
clientServ = new ComServerThread ( ServerSocket. accept () ); 

// - Service a Client - 

System. out . println ( "*** A Client came; Service it ***" ); 

clientServ. start (); /*- Use for multy Threaded - */ 

// clientServ.run(); /* - Use for Single Threaded - */ 

} 

// - Close the Server socket; Server exiting - 

serverSocket. close (); 

return 0; 

} // - End of listen Method - 

} //- End of ComServer dass - 


ServerSocket( iPortNumber) 

Creates a Server socket, bound to the specified port. 

serverSocket.acceptO 

Listens for a connection to be made to this socket and accepts it. The method blocks until a connection is made. It returns a new Socket. 

Service One Client 
ComServerThread 

This dass extended from a Thread; Responsible to Service one dient. The Socket connection will be open between the dient and Server. A simple protocol has to be defined between 
the dient and Server, the Server has to understand what the dient wants from the Server. The dient will send a terminate command, for which the Server will terminate the socket 
connection. The ComServerThread dass is responsible to handle a dient request, until the dient sends a terminate command. 

Code listing 1.2: ComServerThread 


/* * 

* — A dass extended from a Thread; Responsible to Service one dient — 
*/ 
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dass ''' ComServerThread ''' extends Thread 

{ 

private Socket clientSocket = null; 

COM_DATA tDataFromClient; 

COM_DATA tDataToClient; 

ObjectlnputStream oln; 

ObjectOutputStream oOut; 

/ ** 

* — Constructor — 

*/ 

public ComServerThread ( Socket socket ) 

{ 

super ( "ComServerThread" ); 
this . clientSocket = socket; 

} // — End of ComServerThread() constructor — 

/ k k 

* — Overrun from the Thread (super) dass — 

V 

public void run () 

{ 

try { 

// - Create the Writer; will be used to send data to dient - 

oOut = new ObjectOutputStream( clientSocket. getOutputStream () ); 

// - Create the Reader; will be used to get data from dient - 

oln = new ObjectlnputStream( clientSocket. getlnputStream () ); 

// - Create a new protocol object - 

ComProtocol comp = new ComProtocol (); 

// - Send something to dient to indicate that Server is ready - 

tDataToClient = ''' comp. processInput ( null ); ''' 

' ' ' sendDataToClient ' ' ' ( tDataToClient, oOut ); 

//- Get the data from the dient - 

while ( true ) 

{ 

try { 

tDataFromClient = ''' getDataFromClient( oln ) ''' ; 

// - Parse the request and get the reply - 

tDataToClient = ' ' ' comp. processInput ( tDataFromClient ); ' ' ' 

// - Send data to the Client - 

''' sendDataToClient ''' ( tDataToClient, oOut ); 

} 

catch ( EOFException e ) { 

System. out . printin ( "Client Disconnected, Bye, Bye" ); 

break; 

} 

// - See if the Client wanted to terminate the connection - 

if ( tDataToClient. bExit ) 


System. out . println ( "Client said Bye. Bye" ); 

break; 

} 

} 

//- Close resources; This dient is gone - 

comp. Final () ; 
oOut. close (); 
oln.close (); 

ClientSocket. close (); 

} catch ( IOException e ) { 

e.printStackTrace (); 

} 

} // — End of run () Method — 

/ k k 

* Get data from Client 
*/ 

private static COM_DATA '' 'getDataFromClient' '' ( ObjectlnputStream oln ) throws IOException 

{ 

COM_DATA tDataFromClient = null; 

// - Initialize variables - 

// tDataFromClient = new COM_DATA(); 
while ( tDataFromClient == null ) 

{ 

try { 

// - Read Line Number first — 

tDataFromClient = (COM_DATA) oln. readObject (); 

} catch ( ClassNotFoundException e ) { 

System. out .printin ( "ClassNotFound" ); 

} 

} 

System. out . println ( "Get: " + tDataFromClient. comData ); 
return tDataFromClient; 

} // - getDataFromClient () Method - 

/ k k 

* Send data to Client 

V 

private static void '' 'sendDataToClient' '' ( COM_DATA tDataToClient, 

ObjectOutputStream oOut ) throws IOException 


System. out . println ( "Sent: " + tDataToClient. comData ); 
oOut. writeObject ( tDataToClient ); 

return; 

} // -- End of sendDataToClient () Method -- 
} //- End of ComServerThread dass - 


COM_DATA tDataFromClient 

This variable will contain the data object from the client. 

COM_DATA tDataToClient 

This variable will contain the data object to be sent to the client. 

sendDataToClient 

This method sends the data object to the client. 

getDataF romClient 

This method gets the data object from the client. 

processInput( tDataFromClient) 

This method of the dass ComProtocol interprets the client commands and returns the data object that will be sent back to the client. 

Handling the request; implements the communication protocol 
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ComProtocol 

This dass implements, and encapsulates the communication logic (protocol). The protocol is the following: 

1. The dient initiate the connection. 

2. The Server accepts it and sends an acknowledgment notifying that it's ready 

3. The dient sends a request 

4. The Server response based on the request 

1. The dient sends a bye request 

2. The Server acknowledge the bye request and disconnects the socket connection 

3. The dient gets the acknowledgment to the bye 

1. The dient sends a shutdown request 

2. The Server acknowledge the shutdown request and disconnects and also stops listening of other clients. 

3. The dient gets the acknowledgment to the shutdown 


Code listing 1.3: ComProtocol 


dass ' ' 'ComProtocol' ' ' 

{ 

private static final int COM_STATUS_WAITING = 0; 

private static final int COM_STATUS_READY_SENT - 1; 

private static final int COM_STATUS_DATA_SENT - 2; 

private static final int COM_STATUS_WAITING_FOR_TERMINALID = 3; 

private int state = COM_STATUS_WAITING; 

// - Reference to 'BACK-END' module - 

private MqTeAccess mqTe; 

/** 

* Create a protokol object; CA11 MQ INI function 
*/ 

public ComProtocol () 

{ 

int iRet = 0; 

// - Initialize 'BACK-END' modules 

mqTe. ... 

} 

/ -k * 

* - Process the Input and Create the output to the Client - 

* / 

public COM_DATA processlnput ( COM_DATA thelnput ) 

{ 

COM_DATA theOutput; 

// - Initialize Variables 

theOutput = new COM_DATA(); 

// - Check if the Clients want to disconnect - 

if ( thelnput != null ) 

{ 

if ( thelnput. comData . equals ('''"! BYE . @ "''' ) ) 

{ 

// - The Client wants to terminate; Echo data back to dient 

theOutput. comData = "BYE."; 

// - Mark the comunication to be terminated - 

theOutput. bExit = true; 

// - Set the internal state to wait for a new dient - 

state = COM_STATUS_WAITING; 

// - Return Data object to be sent to the dient - 

return theOutput; 

} 

if ( thelnput. comData . equals ('''"! SHUTDOWN . @ "''' ) ) 

{ 

// - The Client wants to terminate; Echo data back to dient 

theOutput. comData = "BYE."; 

// - Mark the comunication to be terminated - 

theOutput. bExit = true; 

// - Teil the Server to stop listening for new clients - 

ComServer. GL_listening = false; 

// - Set the internal state to wait for a new dient - 

state = COM_STATUS_WAITING; 

// - Return Data object to be sent to the dient - 

return theOutput; 

} 

} 

if ( state == COM_STATUS_WAITING ) 

{ 

// - Send ready Message to the Client - 

theOutput. comData = "Ready:"; 

// - Set the internal state ready; and wait for Terminalld - 

State = COM_STATUS_WAITING_FOR_TERMINALID; 

} 

eise if ( state == COM_STATUS_WAITING_FOR_TERMINALID ) 

{ 

int iRet; 

// - Get the Terminal ID - 

sTermld = thelnput.comData; 

// - Call 'BACK-END' modules ... - 

mqTe. ... 

// - Send ready Message with the Server Version to the Client - 

theOutput. comData = "Ready; Server Version 1.0:"; 

// - Set the internal state raedy; and wait for Terminalld - 

State = COM_STATUS_READY_SENT; 

} 

eise if ( state == COM_STATUS_READY_SENT ) 

{ 

int iRet; 

String sCommand = thelnput.comData; 

// - Call 'BACK-END' modules ... 

/* 

** - Check if we should get Response data - 

*/ 

if ( thelnput. iRet == COM_DATA. NOWAIT_FOR_RESPONSE ) { 

// — Set the Output Value - 
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theOutput. iRet = iRet; 
theOutput. comData = 

} 

eise { 

// - Call 'BACK-END' modules - 

mqTe. ... 

// - Set the Output Value - 

theOutput. comData = mqTe. sResponseBuffer ; 

theOutput. iRet = iRet; 

} 

} 

return theOutput; 

} //- End of Method processlnput () - 

} //- End of ComProtocol dass Definition - 


The Data object that goes through the network 


COM_DATA 

is data structure dass that is transmitted through the network. The dass contains only data. 


4 ^ 


Code listing 1.4: 


COM DATA 


* COM_DATA data structure 

* / 

public dass COM_DATA implements Serializable 

{ 

public String comData; 
public boolean bExit; 
public int iRet; 

* - Constants values can be passed in in iRet to the Server - 

*/ 

static final int WAIT_FOR_RESPONSE = 0; 

static final int NOWAIT_FOR_RESPONSE = 1; 

/** 

* Initialize the data structure 
*/ 

public COM_DATA () 

{ 

comData = 

bExit - false; 

iRet = 0; 

} // — End of COM_DATA () Constructor — 

/ -k ~k 

* Copy over it contents 
*/ 

public void copy ( COM_DATA tSrc ) 

{ 

this. comData = tSrc.comData; 

this. bExit = tSrc.bExit; 

this. iRet = tSrc.iRet; 

return; 

} 

} // — End of COM_DATA dass — 


Create the Client 


A dient code for a server/service is usually an API that a user application uses to interface to the Server. With the help of a dient API the user application does not have to know how to 
connect to the Server to get Services. 

ComClient 

This dass is the dient API. The application is using this dass to communicate with the Server. 

The following is the dient dass for the above Server: 




Code listing 1.5: 


ComClient 


- 7 

public dass ComClient 1 

{ ; 

private Socket comSocket; [ 

private ObjectOutputStream oOut; ? 

private ObjectlnputStream oln; J 

private boolean IsItOpen = false; j 

/ * * 1 

*- Open Socket - | 


public void openCom ( String sServerName, 

int iPortNumber ) 


{ 


throws UnknownHostException, 
IOException 


try { 

// - Open Socket for communication - 

comSocket = new Socket ( sServerName, iPortNumber ); 

// - Get Stream to write request to the Server - 

oOut = new ObjectOutputStream( comSocket. getOutputStream () ); 

// - Get Stream// to read from the Server 

oln = new ObjectlnputStream( comSocket. getlnputStream ()); 

// - Set internal Member variable that the Communication opened - 

IsItOpen = true; 

} catch ( java. net . UnknownHostException e ) { 

System. err . println ( "( openCom ;) Don 't know about host : " tsServerName ); 

IsItOpen = false; 
throw ( e ); 

} catch ( java. io . IOException e ) { 

System. err . println ("( openCom :) Couldn ' t get I/O for the connection to: "+ sServerName 
IsItOpen - false; 
throw ( e ); 


) ; 
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} 

} 

* - Check if Socket is open - 

*/ 

public boolean islt0pen() 

{ 

return IsItOpen; 

} 

/ ic * 

* - Get data string from the Server - 

V 

public void getServerData ( COM_DATA tServData ) throws IOException 
{ 

// - Initialize Variables - 

tServData. comData = 

// - Get the Response from the Server - 

try { 

tServData. copy ( (COM_DATA) oln. readObject () ); 

} 

catch ( ClassNotFoundException e ) { 

System, out .printin ( "dass Not Found" ); 

} 

System. out . println ( "Server: " + tServData. comData ); 
if ( tServData. comData . equals ( "BYE." ) ) 

{ 

tServData. bExit = true; 

} 

return; 

} 

/ * * 

* - Send data to the Server - 

V 

public void sendDataToServer ( COM_DATA tServData ) throws IOException 
{ 

// - Send the data string - 

System. out . println ( "Send: " + tServData. comData ); 
oOut. writeObject ( tServData ); 

return; 

} 

/ * + 

* - Close Socket - 

*/ 

public void closeCom() throws IOException 
{ 

oOut. close (); 
oln. close (); 
comSocket. close (); 

IsItOpen = false; 

} 


getServerData( COM_DATA tServData) 

This method reads the data from the Server and copies the values to tServData object. 
sendDataToServer( COM_DATA tServData) 

This method sends the tServData object through the network to the Server. 

oln.readObjectO 

This method returns the data object sent by the Server. 
oOut.writeObject( tServData) 

This method sends the data object to the Server. 


Remote Method Invocation 


Java's Remote Method Invocation (commonly referred to as RMI) is used for client and Server models. RMI is the object oriented equivalent to RPC (Remote procedure call). 

The Java Remote Method Invocation (RMI) System allows an object running in one Java Virtual Machine (VM) to invoke methods on an object running in another Java VM. RMI provides 
for remote communication between programs written in the Java programming language. 

RMI is defined to use only with the Java platform. If you need to call methods between different language environments, use CORBA. With CORBA a Java client can call C++ Server 
and/or a C++ client can call a Java Server. With RMI that can not be done. 


STUB and SKELETON 

The remote method invocation goes through a STUB on the client side and a so called SKELETON on the Server side. 


'CLIENT —> STUB —> 


Network 


—> SKELETON —> REMOTE OBJECT 


Prior to Java 1.2 the skeleton had to be explicitly generated with the rmic tool. Since 1.2 a dynamic skeleton is used, which employs the features of Java Reflection to do its work. 

rmiregistry 

Remote objects can be listed in the RMI Registry. Clients can get a reference to the remote object by querying the Registry. After that, the client can call methods on the remote objects. 
(Remote object references can also be acquired by calling other remote methods. The Registry is really a 'bootstrap' that solves the problem of where to get the initial remote reference 
from.) 


The RMI Registry can either be started within the Server JVM, via the LocateRegistry.creciteRegistryO API, or a separate process called rmiregistry that has to be started before remote 
objects can be added to it, e.g. by the command line in Unix: 




rmiregistry on Unix 


irmiregistry <port> & 
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or under Windows: 



rmiregistry on Windows 


i 

istart rmiregistry <port> 

i 

L_ 


1 


If port is not specified the default 1099 is used. The client will need to connect to this port to access the Registry. 
The Registry can also be started from a program by calling the following code: 

Code section 1: rmiregistry starting 

i i 

limport java.rmi.registry.LocateRegistry ; i 

i i 

'Registry reg = LocateRegistry. createRegistry (iPort); 1 



Objects passed in as parameters to the remote objects's methods will be passed by value. If the remote object changes the passed-in object values, it won't be reflected on the client side, this 
is opposite what happens when a local object is called. Objects that used as parameters for remote methods invocation must implement the java .io.seriaüzabie interface, as they are 
going to be serialized when passed through the network, and a new object will be created on the other side. 

However, exported remote objects passed as parameters are passed by remote reference. 

rmic tool 

RMI Remote object 

The remote object has to either extend the java. rmi. Server. unicastRemoteOb ject object, or be explicitly exported by calling the 

java.rmi.Server.UnicastRemoteObject.exportObject ( ) method. 

RMI clients 

Here is an example of RMI client: 

Code listing 7.10: HelloClient.java 

! 1 

i 1 Import java.rmi.registry.LocateRegistry ; ; 

i " 

i 2 Import java.rmi.registry.Registry; \ 

i 1 

i 3 1 

i 1 

i 4 public dass HelloClient { \ 

i " 

1 5 ! 

' 6 private HelloClient () {} j 

1 7 ! 

1 8 public static void main (String[] args) { j 

I 9 String host = (args.length < 1) ? null : args[0]; j 

[10 try { | 

. i 

II Registry registry = LocateRegistry. getRegistry (host); i 

[12 Hello stub = (Hello) registry. lookup ( "Hello" ); i 

, i 

,13 String response = stub. sayHello (); i 

i ' 

,14 System. out . printin ("response: " + response); i 

i ' 

,15 } catch (Exception e) { ' 

i 1 

,16 System. err . println ("Client exception: " + e. toString ());' 

i 1 

,17 e. printStackTrace () ; 1 

i 1 

il 8 } 1 

i 1 

.19} 1 

■2 o j : 


EJB 


Enterprise JavaBeans (EJB) technology is the server-side component architecture for Java Platform, Enterprise Edition (Java EE). EJB technology enables to create distributed, 
transactional, secure and portable application component objects. 

EJB Supports the development and deployment of component based business applications. Applications written using the Enterprise JavaBeans architecture are scalable, transactional, and 
multi-user secure. These applications may be written once, and then deployed on any Server platform that Supports the Enterprise JavaBeans specification. 

EJB History 
EJB Features 

■ Security Management 

■ Persistence Management 

■ Transaction Management 

■ Distributable Interoperable Management 

■ Exception Management 

Types of EJB 

■ Session Beans 

■ StateFull Session Beans 

■ Stateless Session Beans 

■ Entity Beans 

■ Message Driven Beans 

Problems with EJB as a component based development 
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EJBs are an attempt to create component based application development. With EJBs it is easier to develop components, but the same basic and fundamental maintenance problem will still 
be there. That is the dependencies between the client and the components. The usage of a component is fixed, changes on the component interface cause to break the client code. The same 
client/server problem comes back, that is as the users of a component increases the maintenance of that component getting harder and harder until it goes to impossible. 

For a true component based application development we need to standardize the usage of a component. The client must somehow flexibly figure out automatically how to use a component, 
so component changes don't affect any of the clients using that component. Without that flexibility, a true component based application development will remain as an idea, a dream, a 
theory without significant practical use. If we had that flexibility, it could cause a paradigm shift in the Software development industry. 

JINI was an attempt from Sun to address this flexibility problem. In JINI, the client download the component interface implementation and execute it in the client space. 

So we need to mix (somehow) EJB and JINI technologies to come up with a true flexible component based technology. 

References 

■ Sun EJB Home (http://java.sun.com/products/ejb/) 

See also 

■ EJB in Java EE 

External links 

■ EJB 2 Tutorial, interactive Java Lessons (http://javalessons.com/cgi-bin/fun/java-tutorials-rnain.cgi?sub=ejb&ses=ao789) 


Jini 


After J2EE, Sun had a vision about the next Step of network computing: in a network environment, there would be many independent Services and consumers. That is JavaSpaces. 
JavaSpaces would allow these services/consumers to internet dynamically with each other in a robust way. It can be viewed as an object repository that provides a distributed persistent 
object exchange mechanism (persistent can be in memory or disk) for Java objects. It can be used to störe the System state and implement distributed algorithms. In a JavaSpace, all 
communication partners (peers) communicate by sharing state. It is an implementation of the Tuple spaces idea. 

JavaSpaces is used when someone wants to achieve scalability and availability and at the same time reducing the complexity of the overall System. 

Processes perform simple operations to write new objects into a JavaSpace, take objects from a JavaSpace, or read (make a copy of) objects from the JavaSpace. 

In conventional applications, objects are assembled from the database before presenting to the end user. In JavaSpace applications, we keep the ready made "end user" objects and störe 
them in the JavaSpace. In JavaSpace applications the Services are decoupled from each other; they communicate through objects that they write and read/take from the JavaSpace. Services 
search for objects that they want to take or read from the Space by using template object. 


JINI 


JavaSpaces technology is part of the Java Jini technology. The basic features of JINI are: 

■ No user Intervention is needed when Services are brought on or offline. (In contrast to EJBs where the client program has to know the Server and port number where the EJB is 
deployed. In JINI the client is supposed tofind, discover the Service in the network.) 

■ Seif healing by adapting when Services (consumers of Services) come and go. Services need to periodically renew a lease to indicate that they are still available. 

■ Consumers of JINI Services do not need prior knowledge of the service's implementation. The implementation is downloaded dynamically and run on the consumer JVM, without 
configuration and user intervention. For example, the end user may be presented with slightly different user interface depending which Service is being used at the time. The 
implementation of those user interface code would be provided by the Service being used. 

This fact that the implementation is running on the consumer/client's JVM can increase performance, by eliminating the need of remote calls. 

A minimal JINI network environment consists of: 

■ One or more Services 

■ A lookup-service keeping a list of registered Services 

■ One or more consumers 


The JINI Lookup Service 

The lookup Service is described in the : Jini Lookup Service Specification (reggie). This Service interface defines all operations that are possible on the lookup Service. Clients locate 
Services by requesting with a lookup Server that implements a particular interface. Client asks the lookup Server for all Services that implement the particular Service interface. The lookup 
Service returns Service objects for all registered Services that implement the given interface. The client may invoke methods on that object in order to internet directly with the Server. 

Lookup Discovery 

Jini Discovery and Join Specification describes how does the client find the jini lookup Service. There is a protocol to do that, jini comes with a set of API's that implement that protocol. 
The Jini Discovery Utility Specification defines a set of utility classes that are used to work with the protocol. 

Leasing 

When a Service registers with the lookup Service, it receives a lease from the lookup Service, described in the Jini Distributed Leasing Specification. 

Entries and Templates 
Distributed Events 


Annotations 

Javadoc is Java source code document generator, that was introduced with the Java language from Version 1.0 . Well commented Java code is supposed to have Javadoc tags. Those tags are 
in the / ** ... */ comment blocks, so the Compiler ignores them. A separate utility would read the code and create the Java API html files. 
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The Javadoc API documentations are well known. The Java JDK classes are coming with Javadoc API documentations. Most populär IDE tools automatically read Javadoc tags and 
wherever that dass, attribute or method are used, the tags content are displayed automatically, when the mouse courser is over of the text. 

As Java matured, the "Javadoc concept" was recognized as an excellent tool for other purposes, like generating XML descriptors, or even generating Java code, with the help of the XDoclet 
open source program. 

With the help of the XDoclet program, it was possible to use additional Javadoc tags in the code that this program would understand and generate code or data. For example, Javadoc tags 
were introduced to generate XML descriptors for EJBs. It introduced an additional Step in the build process of an EJB, and compiling the code XDoclet would generate the XML 
descriptors. 

Recognizing its usefulness, in Java 5, annotation was added to the Java language. Annotation tags are NOT inside a comment block, any more. Annotation is part of the dass and it may be 
accessed at runtime. 

Wherever XML descriptors were heavily used, now an alternative way is available that is the Java annotation. From EJB 3.0, it is possible to define EJBs without using XML. Also the new 
JPA (Java Persistent API) using annotations. 

It is important to note, that Javadoc and annotation are two different constructs. 

■ Javadoc tags are inside a comment block and such ignored by the Compiler. 

■ Annotation tags are outside of comment blocks and they are type checked by the Compiler. 


Javadoc 

Java allows users to document the classes and the members by using a particular syntax of comment. 

Syntax 

A documentation comment is framed by slash-star-star and star-slash (i.e. /** ... */). The documentation is in the HTML format. 

Code listing 8.1: Example.java 


1 /** 

2 * A dass to give an <b>example</b> of HTML documentation. 

3 V 

4 public dass Example { 

5 /** ...Documentation of a member with the type integer named example... 

6 public int example; 

7 } 


A documentation comment is placed just above the commented entity (dass, constructor, method, field). 

In a documentation comment, the first part is a description text in the HTML format. The second part is a list of special attributes whose name Starts with an at sign (@): 

Code section 8.1: Documentation comment. 



r 


1 /** 

2 * Get the sum of two integers. 

3 * dparam a The first integer number. 

4 * dparam b The second integer number. 

5 * dreturn The value of the sum of the two given integer 

6 V 

7 public int sum (int a, int b) { 

8 return a + b; 

9 } 


Get the sum of two integers. 

Description of the sum method. 

@param a The first integer number. 

Description attribute of the parameter a of the method. 

@param b The second integer number. 

Description attribute of the parameter b of the method. 

Qreturn The value of the sum of the two given integers. 

Description attribute of the value returned by the method. 


Here is a non exhaustive list of special attributes: 


Attribute and syntax 

In a comment of... 

Description 

@author author 

dass 

Name of the author of the dass. 

@ Version Version 

dass 

Version of the dass. 

@deprecated description 

dass, constructor, method, field 

Flags the entity as deprecated (old Version), describes why and by what replace it. 

If the entity flagged as deprecated by this attribute is used, the Compiler give a warning. 

@see reference 

dass, constructor, method, field 

Add a link in the section "See also". 

@param id description 

constructor and method 

Describes the method parameter. 

@return description 

method 

Describes the value returned by the method. 

@exception type description 

constructor and method 

Describes the reason of the throw of an exception of the specified type (throws clause). 


See also annotations since Java 5. 

Documentation 

The JDK provides a tool named javadoc which allows to generate the documentation of the well commented classes. The javadoc command without argument give the complete syntax of 
the command. 
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Example ; for a dass named Example defined in a package named org . wikibooks . en dans le fichier C : \Prog Java\org\wikibooks\en\Example . java 

Code listing 8.2: Example.java 


1 package org.wikibooks.en; 

2 

3 /** 


1 4 

* An example dass. 


| 5 

*/ 


! 6 

public dass Example { 


| 7 



! 8 

Get the sum of two integers . 


! 9 

Sparam a The first integer number. 

ho 

ßparam b The second integer 

number. 

In 

Sreturn The value of the sum 

of the 

|l 2 

*/ 


!l 3 

public int sum (int a, int b) 

{ 

II 4 

return a + b; 


II 5 

} 


!l 6 

} 



L_! 


The documentation can be generated in a specific folder (C:\ProgDoc for example) with the following command: 


□I 


Command 8.1: Documentation generation 


i$ javadoc -locale en_US -use -classpath C:\ProgJava -sourcepath C:\ProgJava -d C:\ProgDoc org.wikibooks.en 


The options of this command are described below: 

-locale en_US 

The documentation in US English. 

-use 

Create the pages about the use of the classes and the packages. 

-classpath C:\ProgJava 

The path of the compiled classes (*.class). 

-sourcepath C:\ProgJava 

The path of the source classes (*.java). 

-d C:\ProgDoc 

The path where the documentation must be generated. 

org.wikibooks.en 

The name of the package to document. It is possible to specify several packages, or one or several dass names to document only those ones. 

The description page of a package copy the description text from the file named package. html which should be placed in the given folder. In our example, we should document the 
package in the file C : \ Prog Java\org\wikibooks \en\package .html. 

Since Java 5^, the package. html file can be replaced by a special Java file named package-inf o. java containing only the package declaration preceding by a documentation comment. 

Code listing 8.3: C:\Prog3ava\org\wikibooks\en\package-info.java 

i 

|i /** 

12 * This fake package is used to illustrate the Java wikibook. 

13 * at <i>en . wikibooks . org</i> . 

A V 

I 

i5 package org . wikibooks . en; 


References 

1. http://docs.oracle.com/javase/6/docs/technotes/tools/windows/javadoc.html#packagecomment 


Annotations/Introduction 

Introduction 

In Java, an annotation is a language construct that was introduced in J2SE 1.5 that provides a mechanism for including metadata directly in the source code. 

Annotations can provide metadata for java classes, attributes, and methods. Syntactically, annotations can be viewed as special kind of modifier and can be used any where that other 
modifiers (such as public, static, or final) can be used 

One of the main forces of adding this feature to Java was the wide spread use of XML descriptors to add additional Information, metadata for Java classes. Frameworks like EJB, JSF, 
Spring, Hibernate were heavily using external XML descriptors. The problem of those external descriptors is that those files are out of reach of the Java Compiler and for that reason 
Compiler type checking could not be used. A small spelling mistake bug in a huge XML descriptor file is hard to locate and fixed. The Java annotations on the other hand use the Java 
Compiler type checking features, so annotation names spelling mistakes will be caught by the Java Compiler. 

In summary, annotations can be... 

■ used as a source of Information for the Compiler; 

■ made available for compile-time or deployment-time processing; 

■ examined at runtime. 

External links 

■ [1] (http://java.sun.com/docs/books/tutorial/java/javaOO/annotations.html) The Java™ Tutorial on Annotations 
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Annotations/Custom Annotations 


Annotations can be viewed as a source of defining meta-data for a piece of code in Java. The annotation ecodeDescription used in the following sections does not come as a part of the 
Java API. 

Annotation Type Declaration 

Before you can use an annotation with classes, theirs members and Statements or expressions, you need to define an annotation type. Following is the syntax on how to define a type for the 
mentioned annotation. 

Code listing 1.1: Annotation type declaration 


Sinterface CodeDescription 
{ 

String author (); 

String Version (); 

} 


That's it! Our first ever annotation has been defined. Now, we can use it with any of our classes. An annotation definition if you look closely resembles the definition of a normal interface, 
except that the interface keyword is preceded by the @ character. Some refer to this syntactical declaration as the annotation type declaration due to the fact that @ is 'AT or Annotation 
Type' for that very instance. 

Annotation Element Declarations 


What look like methods in the body of the annotation definition are called annotation element declarations. These are the named entities that we used with the annotation body in the 
example in the previous section. However, for the sake of clarity, code below also represents the calling of the following annotation: 


Code listing 1.2: 


Calling of annotation 


i -1 

'public dass MyMethod 1 

g ; 

| ©CodeDescription 1 

! ( I 

, author = "Unknown", ! 

! version = "1.0. 0.1" ! 


) 

public void doSomething () 
{ 



Using a default value 


Now, for instance, you want the annotation to know that if no value for the version element is present, then it should use a default value. Declaring a default value would be done the 
following way. 

Code listing 1.3: Using default values. 


-, 

@interface CodeDescription 1 

{ | 

String author (); 1 

String version () default "1.0. 0.1"; j 

} ! 


So, now if you use the same code again, you can ignore the versi 


ion 


Code listing 1.4: Pre-defined value. 


element because you know that the value is to be provided by default. 


,- 1 

public dass MyMethod 1 

{ ; 

(■•CodeDescription (author = "Sysop") 1 

public void doSomething () 1 

{ ; 

} | 

} I 


Annotations/Meta-Annotations 


There are five annotation types in the java. lang. annotation package called meta-annotations. These annotation types are used to annotate other annotation types. 

Documented 


If a member is annotated with a type itself marked as @Documented, then that member will be documented as annotating that type. 



Code listing 1.1: 


Use of @Documented 


35 sur 77 


30/01/2016 20:10 











Java Programming/Print version2 - Wikibooks, open books for an open... 


https://en. wikibooks .org/w/index.php ?title=Java_Programming/Print_ve... 


ginterface Secret { } 

gDocumented 

ginterface NotSecret { } 

gSecret 

gNotSecret 

public dass Exampie { 

} 


In the documentation for the Exampie dass, such as the JavaDoc, Exampie will be shown as annotated with @Notsecret, but not @secret. 

Inherited 

Exactly as the name sounds, an @ inherited annotation type is inherited by subclasses of an annotated type. 

Code listing 1.2: Use of @Inherited 

r~ -1 

• I 

!@Inherited 1 

1 i 

[@interface ForEveryone { } 1 

• i 

i i 

,@interface JustForMe { } [ 

' i 

' i 

,@ForEveryone [ 

!@JustForMe [ 

i i 

idass Superclass { } , 

• i 

' i 

i i 

iclass Subclass extends Superclass { } , 


In this exampie, Superclass has been explicitly annotated with both @ForEveryone and @ JustForMe. Subclass hasn't been expbcitly marked with either one; however, it inherits 
@ ForEveryone because the latter is annotated with @ inherited. @ JustForMe isn't annotated, so it isn't inherited by Subclass. 

Repeatable 

A @Repeatabie annotation type is repeatable - i.e. can be specified multiple times on the same dass. This meta-annotation was added in Java 8. 

Retention 

Different annotation types have different purposes. Some are intended for use with the Compiler; others are meant to be reflected dynamically at runtime. There's no reason for a Compiler 
annotation to be available at runtime, so the @Retention meta-annotation specifies how long an annotation type should be retained. The vaiue attribute is one of the 
java. lang. annotation.RetentionPoiicy enum constants. The possible values, in order from shortest to longest retention, are as follows: 

RetentionPolicy.SOURCE 

The annotation will not be included in the dass file. This is useful for annotations which are intended for the Compiler only. 

RetentionPolicy.CLASS 

The annotation will be included in the dass file, but cannot be read reflectively. 

RetentionPolicy.RUNTIME 

The annotation can be reflected at runtime. 

If no @Retention pOÜCy is Specified, it defaults to RetentionPolicy. CLASS. 

Target 

The @Target meta-annotation determines what may be marked by the annotation. The vaiue attribute is one or more of the java. lang. annotation. EiementType enum constants. Those 
constants are EiementType . ANNOTATION_TYPE, CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, and TYPE. 


Annotations/Compiler and Annotations 

Annotations can be used by the Compiler to carry out certain directives. Much that you'd love programming in Java, you probably would have been fussed about Compiler warnings. 
Compiler warnings are not necessarily errors but are warnings that teil you the code might malfunction because of some reason. 

Taming the Compiler 

You can issue directive to the Compiler in the shape of three pre-defined annotation to teil it what sort of pre-processing a certain bit of code requires. The three annotations are: 


■ @Deprecated 

■ @Override 

■ @SuppressWarnings( . . ) 

@Deprecated is used to flag that a method or dass should no longer be used, normally because a better alternative exists. Compilers and IDEs typically raise a warning if deprecated code is 
invoked from non deprecated code. [2] (http://java.sun.eom/j2se/l.5.0/docs/api/java/lang/Deprecated.html) 

@ Override flags that a method overrides a method in a superclass. If there is no overridden method, a compile error should occur. [3] (http://java.sun.eom/j2se/l.5.0/docs/api/java/lang 
/Override.html) 

esuppresswarnings (. .) SuppressWarnings teils the Compiler not to report on some, or all, types of warnings. It can be applied to a type, a method or a variable. [4] (http://java.sun.com 
/j2se/1.5.0/docs/api/java/lang/SuppressWamings.html) 

External links 

■ [5] (http://cleveralias.blogs.com/thought_spearmints/2006/01/suppresswarning.html) Advanced usage of the @ SuppressWarnings (. . ) annotation 
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Designing user interfaces 
Basic IO 


This section covers the Java platform classes used for basic input and output. But before we begin we need to have a concrete understanding of what input and output means in 
programming. To grasp this concept, think of the Java platform as a System. 

Understanding input and output 

The Java platform is an isolated entity, a space on your OS in a way, where everything outside this System is its environment. The interaction between the System and its environment is a 
two-way dialog of sorts. Either the System receives messages from its environment, or it conveys its messages to the same. When a message is received to the System, it is called an input, its 
opposite is an output. On a whole, this communication is termed input/output abbreviated as I/O. 

The following chapters are designed to introduce basic input and output in Java, including reading text input from the keyboard, outputting text to the monitor, and reading/writing files from 
the file System. More advanced user interaction using Graphics and Graphical User Interface (GUI) programs is taken up in the later section on Swing. 

Simple Java Output: Writing to the Screen 

Writing to the screen is very easy, and can be accomplished using one of two methods: 



Code section 1.1: Print "Hello world" without advancing to a new line 


'System.out.print ("Hello world"); 



Code section 1.2: Print "Hello world" and advance to a new line 


I- 

i 

■System.out. printin ("Hello world" 

i 

i__ 


Output on the screen 



Output on the screen 



Simple Java Input: Inputting from the keyboard 

As of Version 1.5.0, Java provides a dass in the java. utii package called Scanner that simplifies keyboard input. 




Code section 1.3: Inputting with Scanner 


,Scanner kbdln = new Scanner(System. in ); // Instantiating a new Scanner object 

'System. out . print ( "Enter your name: "); // Printing out the prompt 

iString name = kbdln. nextLine (); // Reading a line of input (until the user hits enter) from the keyboard 1 

// and putting it in a String variable called name 

'System. out . println ( "Welcome, " + name); // Printing out welcome, followed by the user's name 

■ 

l_: 


On the screen 


;-1 

lEnter your name: John Doe 1 
iWelcome, John Doe 1 

I-1 


Alternatively, one could write a method to handle keyboard input: 



Code section 1.4: Line reader 


T 


public String readLine () { 

// Creates a new BufferedReader object 

BufferedReader x = new BufferedReader (new InputStreamReader(System. in )); 

// Reads a line of input and returns it directly 
return x. readline (); 


Note that the code above shouldn't be used in most applications, as it creates new Objects every time the method is run. A better alternative would be to create a separate dass file to handle 
keyboard input. 


Streams 

The most basic input and output in Java (System, in and System, out fields that have been used in the Basic I/O) is done using streams. Streams are objects that represent sources and 
destinations of data. Streams that are sources of data can be read from, and streams that are destinations of data can be written to. A stream in Java is an ordered sequence of bytes of 
undetermined length. Streams are ordered and in sequence so that the java virtual machine can understand and work upon the stream. Streams are analogous to water streams. They exist as 
a communication medium, just like electromagnetic waves in communication. The order or sequence of bytes in a Java stream allow the virtual machine to classify it among other streams. 

Java has various inbuilt streams implemented as classes in the package java. io like the classes of System, in and System, out. Streams can be classed as both input and output streams. All 
Java streams are derived from Input Stream (java. io. inputstream) and Output Stream (java. io. outputstream) classes. They are abstract base classes meant for other stream classes. 
The System, in is the input stream dass derivative and analogically System, out is the output counterpart. Both are basic classes used to directly internet with input and output through 
console, similarly follows System, err. Also Java has streams to communicate across different parts of a program or even among threads. There are also classes that "filter" streams, 
changing one format to another (e.g. dass DataOutputstream, which translates various primitive types to byte streams). 

It is a characteristic of streams that they deal only in one discrete unit of data at a time, and different streams deal with different types of data. If one had a stream that represented a 
destination for bytes, for example, one would send data to the destination one byte at a time. If a stream was a source of byte data, one would read the data a byte at a time. Because this is 
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the only way to access data from a stream, in this latter case, we wouldn't know when we had read all the data from the stream until we actually got there. When reading a stream, one 
generally has to check each unit of data each read Operation to see if the end of the stream has been reached (with byte streams, the special value is the integer -1, or FFFF hex). 

Input streams 

Input streams acquire bytes for our programmed java application/program (e.g. a file, an array, a keyboard or monitor, etc.), inputstream is an abstract dass that represents a source of byte 
data. It has a read () method, which returns the next byte in the stream and a dose () method, which should be called by a program when that program is done with the stream. The 
read () method is overloaded, and can take a byte array to read to. It has a skip () method that can skip a number of bytes, and an avaiiabie () method that a program can use to 
determine the number of bytes immediately avaiiabie to be read, as not all the data is necessarily ready immediately. As an abstract dass, it cannot be instantiated, but describes the general 
behavior of an input stream. A few examples of concrete subclasses would be ByteArrayinputstream, which reads from a byte array, and Fileinputstream, which reads byte data from a 
file. 

In the following example, we print "Hello world!" on the screen several times. The number of times the message is printed is stored in a file named source. txt. This file should only contain 
a integer and should be placed in the same folder of the conf iguredAppücation dass. 

Code listing 9.1: Example of input stream. 


1 Import java.io.File; 

2 import java.io.Fileinputstream; 

3 

4 public dass Conf iguredAppücation { 

5 

6 public static void raain (String[] args) throws Exception { 

7 

8 // Data reading 

9 File file = new File ("source.txt" ); 

10 Fileinputstream stream = new Fileinputstream(file); 

11 

12 StringBuffer buffer = new StringBuffer(); 

13 

14 int character = 0; 

15 while ((character = stream. read ()) != -1) { 

16 buffer. append ( ( char ) character); 

17 } 

18 

19 stream. close (); 

20 

21 // Data use 

22 Integer readlnteger = Integer. parseint (buffer. toString ()); 

23 for (int i = 0; i < readlnteger ; i++) { 

24 System. out . println (" Hello world!"); 

25 } 

26 } 

27 } 


The dass Start to identify the filename with a File object. The File object is used by an input stream as the source of the stream. We create a buffer and a character to prepare the data 
loading. The buffer will contain all the file content and the character will temporary contain each character present in the file, one after one. This is done while {}in the loop. Each iteration 
of the loop will copy a character from the stream to the buffer. The loop ends when no more character is present in the stream. Then we dose the stream. The last part of the code use the 
data we have loaded in from the file. It is transformed into string and then into an integer (so the data must be an integer). If it works, the integer is used to determine the number of time we 
print "Hello world!" on the screen. No try/catch block has been defined for readability but the thrown exceptions should be caught. 


Let's try with the following source file: 

Code listing 9.2: source.txt 
4 


We should obtain this: 

Output for ConfiguredApplication 


,$ java ConfiguredApplication 1 

iHello world! 1 

iHello world! [ 

iHello world! ! 

iHello world! " 

1 , 
i_ 

A I If it shows a FiieNotFoundException or an ioException, the source may not be placed in the right folder or its name is badly spelled. 

| If it shows a NumberFormatException, the content of the file may not be an integer. 

There is also Reader which is an abstract dass that represents a source of character data. It is analogous to inputstream, except that it deals with characters instead of bytes (remember 
that Java uses Unicode, so that a character is 2 bytes, not one). Its methods are generally similar to those of inputstream. Concrete subclasses include classes like FiieReader, which reads 
characters from files, and stringReader, which reads characters from strings. You can also convert an inputstream object to a Reader object with the inputstreamReader dass, which 
can be "wrapped around" an inputstream object (by passing it as an argument in its constructor). It uses a character encoding scheme (which can be changed by the programmer) to 
translate a byte into a 16-bit Unicode character. 

Output streams 

Output Streams direct streams of bytes outwards to the environment from our program or application. output stream is an abstract dass which is the destination counterpart of 
inputstream. Outputstream has a write () method which can be used to write a byte to the stream. The method is overloaded, and can take an array as well. A close () method closes 
the stream when the application is finished with it, and it has a f lush () method. The stream may wait until it has a certain amount before it writes it all at once for efficiency. If the stream 
object is buffering any data before writing it, the f lush () method will force it to write all of this data. Like inputstream, this dass cannot be instantiated, but has concrete subclasses that 
parallel those of Inputstream, eg ByteArrayOutputStream, FileOutputStream, etc. 

In the following example, we störe the current time in an already existing file called log. txt located in the same folder than the dass. 

Code listing 9.2: Example of output stream. 


jimport java.io.File; 
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1 2 Import java.io.FileOutputStream; 

3 Import java . util . Date; 

4 

5 public dass LogTime { 

6 public static void main (String[] args) throws Exception { 

7 // Generate data 

8 String timelnString = new Date () . toString (); 

9 

10 // Store data 

11 File file = new File (" log . txt ") ; 

12 FileOutputStream stream = new FileOutputStream(file); 

13 

14 byte[] timelnBytes = timelnString. getBytes (); 

15 

16 stream.write(timelnBytes); 

17 stream. flush (); 

18 stream. close (); 

19 } 

20 } 


This case is more simple as we can put all the data in the stream at the same time. The first part of the code generate a string containing the current time. Then we create a File object 
identifying the output file and an output stream for this file. We write the data in the stream, flush it and close it. That's all. No try/catch block has been defined for readability but the thrown 
exceptions should be caught. 



The close () is not always mandatory but can avoid some inter-process concurrency conflicts. However if it occurs before a read () or write () (in the same process) they return 
the warning Stream closed. 


AI In order to read a text file several times from the beginning, a Filechannel variable should be introduced, only to reposition the reader. 


Now let's execute it: 


LogTime execution 

!- 1 

i 1 

i$ java LogTime 1 


We should obtain this content: 

Code listing 9.4: log.txt 

Sat Jan 30 19:09:22 CEUTC 2016 

AI If it shows a FileNotFoundException or an ioException, the file should not have been created or it is not placed in the right folder. 

There is also writer which is a character counterpart of outputstream, and a destination counterpart to Reader, this is also an abstract superclass. Particular implementations parallel those 
of Reader, eg FileWriter, stringWriter, and outputstreamWriter, for Converting a regulär outputstream into a reader so that it can take character data. 

System. out and System. err 

System is a dass in the package java. lang with a number of static members that are available to Java programs. Two members that are useful for console output are System, out and 
System, err. Both System.out and System.err are Printstream objects. Printstream is a subclass of FilterOutputstream, itself a subclass of outputstream (discussed above), and its 
main purpose is to translate a wide variety of data types into streams of bytes that represent that data in characters according to some encoding scheme. 

System. out and System. err both display text to a console where the user can read it, however what this means exactly depends on the platform used and the environment in which the 
program is running. In BlueJay and Eclipse IDE, for example, there is a special "terminal" window that will display this output. If the program is launched in Windows, the output will be 
sent to the DOS prompt (usually this means that you have to launch the program from the command line to see the output). 

System.out and System. err differ in what they’re supposed to be used for. system.out should be used for normal program output, system.err should be used to inform the user that 
some kind of error has occurred in the program. In some situations, this may be important. In DOS, for instance, a user can redirect Standard output to some other destination (a file, for 
example), but error output will not be redirected, but rather displayed on the screen. If this weren’t the case, the user might never be able to teil that an error had occurred. 


New I/O 


Versions of Java prior to J2SE 1.4 only supported stream-based blocking I/O. This required a thread per stream being handled, as no other processing could take place while the active thread 
blocked waiting for input or output. This was a major scalability and performance issue for anyone needing to implement any Java network Service. Since the introduction of NIO (New I/O) 
in J2SE 1.4, this scalability problem has been rectified by the introduction of a non-blocking I/O framework (though there are a number of open issues in the NIO API as implemented by 
Oracle). 

The non-blocking IO framework, though considerably more complex than the original blocking IO framework, allows any number of "channels" to be handled by a single thread. The 
framework is based on the Reactor Pattern. 


More Info 

More information on the contents of the java. io package can be viewed on the Oracle website by clicking this link (http://docs.oracle.eom/javase/7/does/api/index.html). 


Event Handling 

The Java platform Event Model is the basis for event-driven programming on the Java platform. 

Event-driven programming 

No matter what the programming language or paradigm you are using, chances are that you will eventually run into a Situation where your program will have to wait for an external event to 
happen. Perhaps your program must wait for some user input, or perhaps it must wait for data to be delivered over the network. Or perhaps something eise. In any case, the program must 
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wait for something to happen that is beyond the program's control: the program cannot make that event happen. 

In this Situation there are two general options for making a program wait for an external event to happen. The first of these is called polling and means you write a little loop of the for 
"while the event has not happened, check again". Polling is very simple to build and very straightforward. But it is also very wasteful: it means a program takes up processor time in order to 
do absolutely nothing but wait. This is usually considered too much of a drawback for programs that have to do a lot of waiting. Programs that have a lot of waiting moments (for example, 
programs that have a graphical user interface and often have to wait for long periods of time until the user does something) usually fare much better when they use the other mechanism: 
event-driven programming. 

In event-driven programming a program that must wait, simply goes to sleep. It no longer takes up processor time, might even be unloaded from memory and generally leaves the Computer 
available to do useful things. But the program doesn't completely go away; instead, it makes a deal with the Computer or the operating System. A deal sort of like this: 

Okay Mr. Operating System, since I have to wait for an event to happen, I'll go away and let you do useful work in the meantime. But in return, 
you have to let me know when my event has happened and let me come back to deal with it. 


Event-driven programming usually has a pretty large impact on the design of a program. Usually, a program has to be broken up into separate pieces to do event-driven programming (one 
piece for general processing and one or more others to deal with events that occur). Event-driven programming in Java is more complicated than non-event driven but it makes far more 
efficient use of the hardware and sometimes (like when developing a graphical user interface) dividing your code up into event-driven blocks actually fits very naturally with your program's 
structure. 

In this module we examine the basis of the Java Platform's facilities for event-driven programming and we look at some typical examples of how that basis has been used throughout the 
platform. 

The Java Platform Event Model 

Introduction 

One of the most interesting things about support for event-driven programming on the Java platform is that there is none, as such. Or, depending on your point of view, there are many 
different individual pieces of the platform that offer their own support for event-driven programming. 

The reason that the Java platform doesn't offer one general implementation of event-driven programming is linked to the origins of the support that the platform does offer. Back in 1996 the 
Java programming language was just getting started in the world and was still trying to gain a foothold and conquer a place for itself in Software development. Part of this early development 
concentrated on Software development tooling like IDEs. One of the trends in Software development around that time was for reusable Software components geared towards user interfaces: 
components that would encapsulate some sort of interesting, reusable functionality into a single package that could be handled as a single entity rather than as a loose collection of individual 
classes. Sun Microsystems tried to get on the component bandwagon by introducing what they called a JavaBean, a Software component not only geared towards the UI but that could also 
be configured easily from an IDE. In order to make this happen Sun came up with a large specification of JavaBeans (the JavaBeans Spec) dealing mostly with naming conventions (to make 
the components easy to handle from an IDE). But Sun also realized at the same time that a Ul-centric component would need support for an event-driven way of connecting events in the 
component to business logic that would have to be written by the individual developer. So the JavaBeans Spec also included a small specification for an event Model for the Java platform. 

When they started working on this Event Model, the Sun engineers were faced with a choice: try to come up with a huge specification to encompass all possible uses of an event model, or 
just specify an abstract, generic framework that could be expanded for individual use in specific situations. They chose the latter Option and so, love it or hate it, the Java Platform has no 
generic support for event-driven programming other than this general Event Model framework. 

The Event Model framework 

The Event Model framework is really very simple in and of itself, consisting of three classes 
(one abstract) and an interface. Most of all it consists of naming conventions that the 
programmier must obey. The framework is depicted in the image on the right. 

Speaking in terms of classes and interfaces, the most important parts of the framework are 
the java .ut.il .EventObject abstract claSS and the java . util. EventListener interface. 

These two types are the centerpieces of the rules and conventions of the Java Platform Event 
Model, which are: 

■ A dass that has to be notified when an event occurs, is called an event listener. An 
event listener has one distinct method for each type of event notification that it is 
interested in. 

■ Event notification method declarations are grouped together into categories. Each 
category is represented by an event listener interface, which must extend 
java. util. EventListener. By Convention an event listener interface is named 
<Event category name> Li stener. Any dass that will be notified of events must implement at least one listener interface. 

■ Any and all state related to an event occurrence will be captured in a state object. The dass of this object must be a subclass of java. util. Event ob ject and must record at least 
which object was the source of the event. Such a dass is called an event dass and by Convention is named <Event category name>Event. 

■ Usually (but not necessarily!) an event listener interface will relate to a single event dass. An event listener may have multiple event notification methods that take the same event 
dass as an argument. 

■ An event notification method usually (but not necessarily!) has the conventional signature public void <specific event>(<Event category name>Event evt). 

■ A dass that is the source of events must have a method that allows for the registration of listeners, one for each possible listener interface type. These methods must by Convention 
have the signature public void add<Event category name>Listener(<Event category name>Listener listener). 

■ A dass that is the source of events may have a method that allows for the deregistration of listeners, one for each possible listener interface type. These methods must by Convention 
have the signature public void remove<Event category name>Listener(<Event category name>Listener listener). 

That seems like a lot, but it's pretty simple once you get used to it. Take a look at the image on the left, 
which contains a general example of how you might use the framework. In this example we have a 
dass called Eventsourceciass that publishes interesting events. Following the rules of the Event 
Model, the events are represented by the interestingEvent dass which has a reference back to the 

EventSourceClass object (source, inherited from java .util . EventObject). 

Whenever an interesting event occurs, the Event Sourceciass must notify all of the listeners for that 
event that it knows about by calling the notification method that exist for that purpose. All of the 
notification methods (in this example there is only one, interestingEventoccurred) have been 
grouped together by topic in a listener interface: interestingEventListener, which implements 
java .util .EventListener and is named according to the Event Model conventions. This interface 
must be implemented by all event listener classes (in this case only 

InterestingEventListenerlmpl). Because EventSourceClass must be able tO notify any 
interested listeners, it must be possible to register them. For this purpose the EventSourceClass has 
an addi nt erestingEvent Li stener method. And since it is required, there is a 

removelnterestingEventListener method as well. 

As you can clearly see from the example, using the Event Model is mostly about following naming 
conventions. This might seem a little cumbersome at first, but the point of having naming conventions 
is to allow automated tooling to access and use the event model. And there are indeed many tools, IDEs and frameworks that are based on these naming conventions. 



java. util 


EventObject 


"source: Object 


+EventObject(source: Object) 
+getSource(): Object 
+toStringO: String 


«interface>> 

EventListener 


o 


EventListenerProxy 


■+EventListenerProxy(listener: EventListener) 
+getEventListener(): EventListener 


TooManyListenersException 


+T ooManyListenersException 0 
+TooManyListenersExceptjon(message: String) 


The basic Event Model framework 
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Degrees of freedom in the Model 

There's one more thing to notice about the Event Model and that is what is not in the Model. The Event Model is designed to allow implementations a large degree of freedom in the 
implementation choices made, which means that the Event Model can serve as the basis for a very wide ränge of specific, purpose-built event handling Systems. 

Aside from naming conventions and some base classes and interfaces, the Event Model specifies the following: 

■ It must be possible to register and deregister listeners. 

■ An event source must publish events by calling the correct notification method on all registered listeners. 

■ A call to an event notification method is a normal, synchronous Java call and the method must be executed by the same thread that called it. 

But the Event Model doesn't specify how any of this must be done. There are no rules regarding which classes exactly must be event sources, nor about how they must keep track of 
registered event listeners. So one dass might publish its own events, or be responsible for Publishing the events that relate to an entire collection of objects (like an entire component). And 
an event source might allow listeners to be deregistered at any time (even in the middle of handling an event) or might limit this to certain times (which is relevant to multithreading). 

Also, the Event Model doesn't specify how it must be embedded within any program. So, while the model specifies that a call to an event handling method is a synchronous call, the Model 
does not prescribe that the event handling method cannot hand off tasks to another thread or that the entire event model implementation must run in the main thread of the application. In 
fact, the Java Platform's Standard user interface framework (Swing) includes an event handling implementation that runs as a complete Subsystem of a desktop application, in its own thread. 

Event notification methods, unicast event handling and event adaptors 

In the previous section we mentioned that an event notification method usually takes a single argument. This is the preferred Convention, but the specification does allow for exceptions to 
this rule if the application really needs that exception. A typical case for an exception is when the event notification must be sent across the network to a remote System though non-Java 
means, like the CORBA Standard. In this case it is required to have multiple arguments and the Event Model allows for that. However, as a general rule the correct format for a notification 
method is 

Code section 1.1: Simple notification method 

I-1 

i i 

«public void specificEventDescription (Event_type evt)i 

i i 



Another thing we mentioned earlier is that, as a general rule, the Event Model allows many event listeners to register with a single event source for the same event. In this case the event 
source must broadcast any relevant events to all the registered listeners. However, once again the Event Model specification allows for an exception to the rule. If it is necessary from a 
design point of view you may limit an event source to registering a single listener; this is called unicast event listener registration. When unicast registration is used, the registration method 
must be declared to throw the java .utn . TooManyListenersException exception if too many listeners are registered: 



Code section 1.2: Listener registration 



'public void add<Event_type>Listener(<Event_type>Listener listener) throws java. uti1 . TooManyListenersExcept iom 




Finally, the specification allows for one more extension: the event adaptor. An event adaptor is an implementation of an event listener interface that can be inserted between an event source 
and an actual event listener dass. This is done by registering the adaptor with the event source object using the regulär registration method. Adaptors are used to add additional functionality 
to the event handling mechanism, such as routing of event objects, event filtering or enriching of the event object before processing by an actual event handler dass. 

A simple example 

In the previous section we've explored the depths (such as there are) of the Java platform Event Model framework. If you're like most people, you've found the theoretical text more 
confusing than the actual use of the model. Certainly more confusing than should be necessary to explain what is, really, quite a simple framework. 

In order to clear everything up a bit, let's examine a simple example based on the Event Model framework. Let's assume that we want to write a program that reads a stream of numbers 
input by the user at the command line and processes this stream somehow. Say, by keeping track of the running sum of numbers and producing that sum once the stream has been completely 
read. 

Of course we could implement this program quite simply with a loop in a main() method. But instead let's be a little more Creative. Let’s say that we want to divide our program neatly into 
classes, each with a responsibility of its own (like we should in a proper, object-oriented design). And let’s imagine that we want it to be possible not only to calculate the sum of all the 
numbers read, but to perform any number of calculations on the same number stream. In fact, it should be possible to add new calculations with relative ease and without having to affect 
any previously existing code. 

If we analyze these requirements, we come to the conclusion that we have a number of different responsibilities in the program: 


■ Reading the number stream from the command line 

■ Processing the number stream (possibly multiple of these) 

■ Starting the entire program 


Using the Event Model framework allows us to separate the two main responsibilities cleanly and affords us the flexibility we are looking for. If we implement the logic for reading the 
number stream in a single dass and treat the reading of a single number as an event, the Event Model allows us to broadcast that event (and the number) to as many stream processors as we 
like. The dass for reading the number stream will act as the event source of the program and each stream processor will be a listener. Since each listener is a dass of its own and can be 
registered with the stream reader (or not) this means our model allows us to have multiple, independent stream processing that we can add on to without affecting the code to read the stream 
or any pre-existing stream processor. 

The Event Model says that any state associated with an event should be included in a dass that represents the event. That’s perfect for us; we can implement a simple event dass that will 
record the number read from the command line. Each listener can then process this number as it sees fit. 


41 sur 77 


30/01/2016 20:10 

















































Java Programming/Print version2 - Wikibooks, open books for an open... https://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


For our interesting event set let's keep things simple: let's limit ourselves to having read a new number and having reached the end of the stream. With this choice we come to the following 
design for our example application: 



In the following sections we look at the implementation of this example. 

Example basics 

Let's Start with the basics. According to the Event Model rules, we must define an event dass to encapsulate our interesting event. We should call this dass something-somethingEvent. Let’s 
go for NumberReadEvent, since that's what will interest us. According to the Model rules, this dass should encapsulate any state that belongs with an event occurrence. In our case, that's 
the number read from the stream. And our event dass must inherit from java. util. Eventobject. So all in all, the following dass is all we need: 

Code listing 1.1: NumberReadEvent. 


package org.wikibooks.en.javaprogramming.example; 

Import java.util.EventObject; 

public dass NumberReadEvent extends EventObject { 
private Double number; 

public NumberReadEvent (Object source, Double number) { 
super (source); 
this. number — number; 

} 

public Double getNumber () { 

return number; 

} 

} 


Next, we must define a listener interface. This interface must define methods for interesting events and must extend java. util. EventListener. We said earlier our interesting events were 
"number read" and "end of stream reached", so here we go: 

Code listing 1.2: NumberReadListener. 


package org.wikibooks.en.javaprogramming.example; 

Import java.util.EventListener ; 

public interface NumberReadListener extends EventListener { 
public void numberRead (NumberReadEvent numberReadEvent); 

public void numberStreamTerminated (NumberReadEvent numberReadEvent); 

} 


Actually the numberStreamTerminated method is a little weird, since it isn't actually a "number read" event. In a real program you'd probably want to do this differently. But let's keep 
things simple in this example. 

The event listener implementation 

So, with our listener interface defined, we need one or more implementations (actual listener classes). At the very least we need one that will keep a running sum of the numbers read. We 
can add as many as we like, of course. But let's stick with just one for now. Obviously, this dass must implement our NumberReadListener interface. Keeping a running summation is a 
matter of adding numbers to a field as the events arrive. And we wanted to report on the sum when the end of the stream is reached; since we know when that happens (i.e. the 

numberStreamTerminated method is called), a simple printin Statement will do: 

Code listing 1.3: NumberReadListenerlmpl. 


package org.wikibooks.en.javaprogramming.example; 

public dass NumberReadListenerlmpl Implements NumberReadListener { 
Double totalSoFar = OD; 
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@Override 

public void numberRead (NumberReadEvent numberReadEvent) { 

totalSoFar += numberReadEvent. getNumber (); 

} 

@Override 

public void numberStreamTerminated (NumberReadEvent numberReadEvent) { 
System. out . println (" Sum of the number stream: " + totalSoFar); 

} 


So, is this code any good? No. It's yucky and terrible and most of all not thread safe. But it will do for our example. 

The event source 

This is where things get interesting: the event source dass. This is the interesting place because this is where we must put code to read the number stream, code to send events to all the 
listeners and code to manage listeners (add and remove them and keep track of them). 

Let’s Start by thinking about keeping track of listeners. Normally this is a tricky business, since you have to take all sorts of multithreading concerns into account. But we’re being simple in 
this example, so let’s just stick with a simple java .utn. Set of listeners. Which we can initialize in the constructor: 

Code section 1.1: The constructor 


private Set<NumberReadListener> listeners; 
public NumberReader () { 

listeners = new HashSet<NumberReadListener>(); 

} 



That choice makes it really easy to implement adding and removing of listeners: 



Code section 1.2: The register/deregister 


T 


public void addNumberReadListener (NumberReadListener listener) { 
this. listeners. add (listener); 

} 

public void removeNumberReadListener (NumberReadListener listener) { 
this . 1 isteners . remove (listener); 

} 


We won’t actually use the remove method in this example — but recall that the Model says it must be present. 

Another advantage of this simple choice is that notification of all the listeners is easy as well. We can just assume any listeners will be in the set and iterate over them. And since the 
notification methods are synchronous (rule of the model) we can just call them directly: 

Code section 1.3: The notifiers 


private void notifyListenersOfEndOfStream () { 

for (NumberReadListener numberReadListener : listeners) { 

numberReadListener. numberStreamTerminated (new NumberReadEvent (this, OD) ) ; 

} 

} 

private void notifyListeners (Double d) { 

for (NumberReadListener numberReadListener: listeners) { 

numberReadListener. numberRead (new NumberReadEvent (this, d)); 

} 

} 



Note that we’ve made some assumptions here. For Starters, we’ve assumed that we'll get the Double value d from somewhere. Also, we’ve assumed that no listener will ever care about the 
number value in the end-of-stream notification and have passed in the fixed value 0 for that event. 

Finally we must deal with reading the number stream. We’ll use the Console dass for that and just keep on reading numbers until there are no more: 

Code section 1.4: The main method 


public void Start () { 

Console console = System. console (); 
if (console != null) { 

Double d = null; 
do { 

String readLine = console. readLine ( "Enter a number: ", (Object[ ]) null) ; 
d = getDoubleValue(readLine); 

if (d != null) { 

notifyListeners(d); 

} 

} while (d != null); 

notifyListenersOfEndOfStream(); 

} 

} 



Note how we’ve hooked the number-reading loop into the event handling mechanism by calling the notify methods? The entire dass looks like this: 


Code listing 1.4: NumberReader. 

i-- 

'package org.wikibooks.en.javaprogramming.example; 

'Import java.io.Console; 

'Import java.util.HashSet ; 
jimport java.util.Set ; 

,public dass NumberReader { 

, private Set<NumberReadListener> listeners; 
i public NumberReader () { 

i listeners = new HashSet<NumberReadListener> (); 

! } 
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public void addNumberReadListener (NumberReadListener listener) { 
this.listeners.add(listener) ; 

} 

public void reraoveNumberReadListener (NumberReadListener listener) { 
this.listeners. remove (listener); 

} 

public void Start () { 

Console console = System. console (); 
if (console ! = null) { 

Double d = null; 
do { 

String readLine = console. readLine ( "Enter a number: ", (Object[]) null) ; 
d = getDoubleValue(readLine); 

if (d != null) { 

notifyListeners(d); 

} 

} while (d != null); 

notifyListenersOfEndOfStream(); 

} 

} 

private void notifyListenersOfEndOfStream () { 

for (NumberReadListener numberReadListener: listeners) { 

numberReadListener. numberStreamTerminated (new NumberReadEvent (this, OD)); 

} 


private void notifyListeners (Double d) { 

for (NumberReadListener numberReadListener: listeners) { 

numberReadListener. numberRead (new NumberReadEvent (this, d)); 

} 

} 

private Double getDoubleValue (String readLine) { 

Double result; 

try { 

result = Double. valueOf (readLine); 

} catch (Exception e) { 
result = null; 

} 

return result; 


} 

} 



Running the example 

Finally, we need one more dass: the kickoff point for the application. This dass will contain a main() method, plus code to create a NumberReader, a listener and to combine the two: 


Code listing 1.5: Main. 



package org.wikibooks.en.javaprogramming.example; 


public dass Main { 

public static void main (String[] args) { 

NumberReader reader = new NumberReader(); 

NumberReadListener listener = new NumberReadListenerImpl(); 
reader. addNumberReadListener (listener); 
reader. Start (); 


} 

} 



If you compile and run the program, the result looks somewhat like this: 




An example run 


>java org.wikibooks.en.javaprogramming.example.Main 

Enter a number: 0.1 

Enter a number: 0.2 

Enter a number: 0.3 

Enter a number: 0.4 

Enter a number: 




Output 


Sum of the number stream: 1.0 


Extending the example with an adaptor 

Next, let's take a look at applying an adaptor to our design. Adaptors are used to add functionality to the event handling process that: 

■ is general to the process and not specific to any one listener; or 

■ is not supposed to affect the implementation of specific listeners. 

According to the Event Model specification a typical use case for an adaptor is to add routing logic for events. But you can also add filtering or logging. In our case, let's do that: add logging 
of the numbers as "proof" for the calculations done in the listeners. 

An adaptor, as explained earlier, is a dass that sits between the event source and the listeners. From the point of view of the event source, it masquerades as a listener (so it must implement 
the listener interface). From the point of view of the listeners it pretends to be the event source (so it should have add and remove methods). In other words, to write an adaptor you have to 
repeat some code from the event source (to manage listeners) and you have to re-implement the event notification methods to do some extra stuff and then pass the event on to the actual 
listeners. 

In our case we need an adaptor that writes the numbers to a log file. Keeping it simple once again, let's settle for an adaptor that: 
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■ Uses a fixed log file name and overwrites that log file with every program run. 

■ Opens a FileWriter in the constructor and just keeps it open. 

■ Implements the numberRead method by writing the number to the FileWriter. 

■ Implements the numberStreamTerminated method by closing the FileWriter. 

Also, we can make life easy on ourselves by just copying all the code we need to manage listeners over from the NumberReader dass. Again, in a real program you'd want to do this 
differently. Note that each notification method implementation also passes the event on to all the real listeners: 

Code listing 1.6: NumberReaderLoggingAdaptor. 


package org.wikibooks.en.javaprogramming.example; 

import java.io.BufferedWriter ; 
import java.io.FileWriter ; 
import java.io.IOException; 
import java.util.HashSet; 
import java.util.Set ; 

public dass NumberReaderLoggingAdaptor implements NumberReadListener { 
private Set<NumberReadListener> listeners; 
private BufferedWriter output; 

public NumberReaderLoggingAdaptor () { 

listeners = new HashSet<NumberReadListener>(); 

try { 

output = new BufferedWriter (new FileWriter( "numberLog.log" )); 
} catch (IOException e) { 

// TODO Auto-generated catch block 
e.printStackTrace (); 

} 

} 

public void addNumberReadListener (NumberReadListener listener) { 
this. listeners. add(listener); 

} 

public void removeNumberReadListener (NumberReadListener listener) { 
this . 1 isteners . remove (listener) ; 

} 

@Override 

public void numberRead (NumberReadEvent numberReadEvent) { 

try { 

output. write (numberReadEvent. getNumber () + "\n"); 

} catch (Exception e) { 

} 

for (NumberReadListener numberReadListener: listeners) { 
numberReadListener. numberRead (numberReadEvent); 

} 

} 

@Override 

public void numberStreamTerminated (NumberReadEvent numberReadEvent) { 

try { 

output. flush (); 
output. close (); 

} catch (Exception e) { 

} 

for (NumberReadListener numberReadListener: listeners) { 

numberReadListener. numberStreamTerminated (numberReadEvent); 

} 

} 

} 


Of course, to make the adaptor work we have to make some changes to the bootstrap code: 

Code listing 1.7: Main. 


package org.wikibooks.en.javaprogramming.example; 
public dass Main { 

public static void main (String[] args) { 

NumberReader reader = new NumberReader(); 

NumberReadListener listener = new NumberReadListenerImpl(); 
NumberReaderLoggingAdaptor adaptor = new NumberReaderLoggingAdaptor(); 
adaptor. addNumberReadListener (listener); 
reader. addNumberReadListener (adaptor); 
reader. Start (); 

} 

} 


But note how nicely and easily we can re-link the objects in our System. The fact that adaptors and listeners both implement the listener interface and the adaptor and event source both look 
like event sources means that we can hook the adaptor into the System without having to change a single Statement in the classes that we developed earlier. 

And of course, if we run the same example as given above, the numbers are now recorded in a log file. 

Platform uses of the Event Model 

The Event Model, as mentioned earlier, doesn't have a single all-encompassing implementation within the Java platform. Instead, the model serves as a basis for several different purpose- 
specific implementations, both within the Standard Java platform and outside it (in frameworks). 

Within the platform the main implementations are found in two areas: 

■ As part of the JavaBeans classes, particularly in the support classes for the implementation of PropertyChangeListeners. 

■ As part of the Java Standard UI frameworks, AWT and Swing. 
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Canvas 


An essential part of programming in Java requires you build exciting new user interfaces for yourselves. Components that come built into the Java framework are regulär UI elements, 
however for a more rieh experience, you need Controls of your own. Take, for instance, a charting application. No charting tool comes built into a Java API. You need to manually draw the 
chart yourself. 

Coding drawing, to begin with, is pretty daunting but once you know the basics of Graphics programming in Java, you can create elegant graphics and art in no time. But the question that 
arises in one's mind is what to draw on. The answer to this question is simpler than it seems. You can Start drawing on any component in the Java framework. Whether it be a panel, window 
or even a button. 

Let me break it down for you. A component in the Java language is a dass that has been derived from the component dass. Each component has a method with a signature 
paint (Graphics ) which can be overridden to manually draw something atop it. 

Overriding the paint (Graphics) method 

Below is an example on how you need to override the above method. For this very example, the component dass that we would be using would be the canvas dass. For more information 
about the canvas dass, see the section on Understanding the Canvas class 

Code listing 9.1: Initializing a Canvas class 


Import java.awt.*; 

public class MyCanvas extends Canvas { 

public MyCanvas () { 

//. . . 

} 

public void paint (Graphics graphics) { 

/* We override the method here. The graphics 
* Code comes here within the method body. */ 

} 

} 


Understanding the Canvas class 

Code listing 9.1 shows the simplicity and power of the syntax for enabling the graphics functions within Java. Fets begin by understanding what a canvas dass does. A canvas dass is a 
derivative or a sub-class of the component dass and when placed over a Frame, displays as a blank area. 

For the purpose of drawing graphics, you may use any other dass derived from the component dass, for instance, jpanei or even jTextFieid or jßutton. Why we use the canvas dass is 
purely to grasp the idea of drawing in Java. 

Fet us refine the above code for the dass to be executable and the Canvas to be displayed. For this we will add an entry-point method namely the main (string [ ]) method in its body and 
calling a jFrame dass to load the canvas on. 

Code listing 9.2: Displaying a Canvas class atop a DFrame 


Import j ava.awt.* ; 

Import javax.swing.* ; 

public class MyCanvas extends Canvas { 
public MyCanvas () { 

} 

public void paint (Graphics graphics) { 

} 

public static void main (String[] args) { 

// We initialize our class here 
MyCanvas canvas = new MyCanvas(); 

JFrame frame = new JFrame(); 
frame. setSize ( 400, 400); 

frame.s etDefaultCloseOperation (JFrame. EXIT_ON_CLOSE ); 
// Here we add it to the frame 
frame. getContentPane (). add (canvas); 
frame. setVisible (true) ; 

} 

} 


The following code now helps our dass to be executable and displays the canvas on top of the frame as it displays. Running this dass would result in an empty frame, however it should be 
clear that the canvas is sitting atop it and is merely not displaying any drawings yet. 
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Figure 9.1: A blank canvas atop a JFrame 


Get, set, draw! 

Now that the basic stracture of our program has been laid out, we need to explore how drawing is actually done by writing Java code. Move to the next section and try your hand at drawing 
basic shapes and lines. But whilst you are still fresh to the concept of a Canvas, why not test your knowledge. Try answering these questions below. 

Question 9.1: What classes are used to draw in Java? 

1. Any dass that is derived from the Object dass. 

2. Any dass that is derived from the component dass. 

3. None of the above. 

Answer 

2 

A dass derived from the Object dass is not viable as a visible component, whereas a dass derived from a component dass is a visible entity atop a Container hence a likely 
candidate for displaying drawings. 

Question 9.2: What is the method that needs to be overridden in order to enable drawing? 

1. The main (String [] ) method. 

2. The MyCanvas () method. 

3. The paint (Graphics) method. 

4. None of the above. 

Answer 

3 

As discussed earlier the paint (Graphics) method is the correct Option. The name says it all. 


Graphics 

Graphics - Drawing in Java 

■ Drawing basic shapes 

■ Drawing complex shapes 

■ Drawing text 

■ Understanding gradients 

■ Anti-aliasing basic s 

■ Interactive drawings 


Graphics/Drawing shapes 


Introduction to Graphics 

Throughout this chapter, we will refer to the process of creating Graphical content with code as either drawing or painting. However, Java officially recognizes the latter as the proper word 
for the process, but we will differentiate between the two later on. 

Now, the main dass that you would be needing would, without doubt, be the Graphics dass. If you take a closer look at the method that we used in theldentifying the acquisition of the 
Graphics dass in our code 


Code listing 9.3: A basic canvas 
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ilmport java.awt.*; 
ilmport javax.swing.* ; 

ipublic dass MyCanvas extends Canvas { 
i public MyCanvas () { 

! } 

i public void paint (Graphics graphics) { 

1 /* We would be using this method only for the sake 

1 * of brevity throughout the current section. Note 

1 * that the Graphics dass has been acquired along 

1 * with the method that we overrode. */ 

\ } 

| public static void main (String[] args) { 

, MyCanvas canvas = new MyCanvas(); 

, JFrarae frame = new JFrame(); 

| frame. setSize ( 400, 400); 

| frame. setDefaultCloseOperation (JFrame. EXIT_ON_CLOSE ); 

i frame. getContentPane () . add (canvas); 

i frame. setVisible (true) ; 

! } 

!} 

L_ 


To view the contents of the Graphics 


dass, please check the external links at the bottom of the page for links to the on li ne API. 


Etching a line on the canvas 


Understanding Coordinates 

To Start off your drawing experience, consider drawing the most basic shape — a line. A canvas when viewed upon with regards to drawing routines can be expressed as an inverted 
Cartesian coordinate System. A plane expressed by an x- and a y-axis. The origin point or (0, 0) being the top-left corner of a canvas and the visible area of the canvas being the Cartesian 
quadrant I or the positive-positive (+,+) quadrant. The further you go down from the top, the greater the value of y-coordinate on the y-axis, vice-versa for the x-axis as you move toward 
the right from the left. And unlike the values on a normal graph, the values appear to be positive. So a point at ( 10 . 20 ) would be 10 pixels away from the left and 20 pixels away from the 
top, hence the format (x, y )• 


Drawing a simple line across the screen 


Now, we already know that a line is a connection of two discreet points atop a canvas. So, if one point is at (xl, 2/1) and 
the other is at (x2, y 2), drawing a line would require you to write a syntax like code below. For the sake of brevity, we 
will skim out the re st of the method unused in the example. 



Code section 9.4: Drawing a simple line form 


public dass MyCanvas extends Canvas { 

public void paint (Graphics graphics) { 
graphics. setColor (Color. black) ; 
graphics. drawLine (40, 30, 330, 380); 

} 

} 


In the above example, a simple method is used to define precisely where to place the line on the Cartesian scale of the 
canvas. The drawLine (int, int, int, int) asks you to put four arguments, appearing in order, the xl coordinate, the 
yl coordinate, the x2 coordinate and the y2 coordinate. Running the program will show a simple black line diagonally 
going across the canvas. 



Figure 9.2: A simple line form displayed across the canvas from Code 
section 9.4 


Drawing a simple rectangle 

We now proceed on to our second drawing. A simple rectangle would do it justice, see below for code. 

Code section 9.5: Drawing a simple rectangle 

;-1 

i 1 

'public dass MyCanvas extends Canvas { J 

i 1 

i public void paint (Graphics graphics) { i 

' graphics.drawRect(10, 10, 100, 100); j 

! } 

i 1 

'} ! 



B 


EME 


In the above example, you see how easy it is to draw a simple rectangle using the drawRect (int, int, int, int) 
method in the Graphics instance that we obtained. Run the program and you will see a simple black outline of a 
rectangle appearing where once a blank canvas was. 


The four arguments that are being passed into the method are, in order of appearance, the x-coordinate, the 
y-coordinate, width and the height. Hence, the resultant rectangle would Start painting at the point on the screen 10 
pixels from the left and 10 from the top and would be a 100 pixel wide and a 100 pixel in height. To save the argument 
here, the above drawing is that of a square with equal sides but squares are drawn using the same method and there is no 
Such method as drawSquare (int, — int, — int) 


Figure 9.3: A simple black-outlined rectangle drawn 


Playing around with colors 

You can change the color of the outline by telling the Graphics instance the color you desire. This can be done as follows: 


m 


Code section 9.6: Changing the outline color of the rectangle 
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public dass MyCanvas extends Canvas { 

public void paint (Graphics graphics) { 
graphics. setColor (Color.red); 
graphics. drawRect (100, 100, 500, 500); 


Running the program would render the same rectangle but with a red colored outline. 

For the purposes of bringing color to our drawing, we used a method namely the setColor (Coior ) method. This method 
comes into force for all the drawing made after its call until another color is set. It asks for an argument of type coior. 
Now because you have no idea of how to actually instantiate a coior dass, the dass itself has a few built-in colors. Some 
built-in colors that you can use are mentioned below. 


■ Color.red 

■ Color.blue 

■ Color.green 

■ Color.yellow 

■ Color.pink 

■ Color.black 

■ Color.white 

Try running the program while coding changes to colors for a different colored outline each time. Play around a bit with 
more colors. Look for the Color dass API documentation in the external links at the bottom of the page. 



Filling up the area of the rectangle 

Up until now, you have been able to draw a simple rectangle for yourself while asking a question silently, "why is the 
outline of the rectangle being painted rather the area as a whole?" The answer is simple. Any method that Starts with 
drawXxxx (...) only draws the outline. To paint the area within the outline, we use the f mxxxx (...) methods. For 
instance, the code below would fill a rectangle with yellow color while having a red outline. Notice that the arguments 
remain the same. 

Code section 9.7: Drawing a yellow rectangle with a red outline 


public dass MyCanvas extends Canvas { 

public void paint (Graphics graphics) { 
graphics. setColor (Color. yellow) ; 
graphics. fillRect (10, 10, 100, 100); 

graphics .setColor (Color.red); 
graphics. drawRect (10, 10, 100, 100); 

} 

} 




What about a circle? 

Drawing a circle is ever so easy? It is the same process as the syntax above only that the word Reet is changed to the 
word oval. And don't ask me why oval? You simply don't have the method drawcircie (int, int, int) as you don’t 
have drawsquare (int, int, int) . Following is the application of Graphics code to draw a circle just to whet your 
appetite. 

Code section 9.8: Drawing a white circle with a blue outline 


public dass MyCanvas extends Canvas { 

public void paint (Graphics graphics) { 

graphics .setColor (new Color (0, 0, 255)); 
graphics. drawOval (50, 50, 100, 100); 

} 

} 







° 


Figure 9.6: A white circle drawn with a blue outline 


A new form of a rectangle 

Simple so far, isn’t it? Of all the shapes out there, these two are the only shapes that you'd need to build for the moment. Complex graphics routines are required to build shapes like a 
rhombus, triangle, trapezium or a parallelogram. We would be tackling them later on in another section. However, on a last note I would leave you with another interesting shape - a 
combination of both ovals and rectangle. Think a rectangle with rounded corners, a Rounded Rectangle (RoundRect). 

Code section 9.9: Drawing a pink rounded rectangle with a red outline 


public dass MyCanvas extends Canvas { 

public void paint (Graphics graphics) { 
graphics. setColor (Color. pink) ; 

graphics. fillRoundRect (10, 10, 100, 100, 5, 5); 
graphics .setColor (Color.red); 

graphics. drawRoundRect (10, 10, 100, 100, 5, 5); 

} 

} 
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Notice that the syntax of the drawRoundRect (int, int, int, int, int, int ) method is abit different than the 
syntax for the simple rectangle drawing routine drawRect (int, int, int, int ). The two new arguments added at the 
end are the width of the arc in pixels and the height of the arc in pixels. The result is pretty amazing when you run the 
program. You don't need to squint your eyes to teil that the corners of the rectangle are slightly rounded. The more the 
values of the width and height of the arcs, the more roundness appears to form around the corner. 

Hmm, everything's perfect, but... 

Sometimes people ask, after creating simple programs like the ones above, questions like: 

■ Why did I have to teil the Graphics instance the color before each drawing routine? Why can't it remember 
my choice for the outlines and for the fill colors? The answer is simpler than it seems. But, to fully understand it, 
we need to focus on one little thing called the Graphics Context. The graphics context is the information that 
adheres to a single instance of the Graphics dass. Such an instance remembers only one color at a time and that is 
why we need to make sure the context knows of the color we need to use by using the setcoior (Color) method. 

■ Can I manipulate the shapes, like tilt them and crop them? Hold your horses, cowboy! Everything is possible in 
Java, even tilting and cropping drawings. We will be focusing on these issues in a later section. 

■ Is making shapes like triangles, rhombuses and other complex ones tedious? Well, to be honest here, you need 
to go back to your dusty book cabinet and take out that High School Geometry book because we would be 
covering some geometry basics while dealing with such shapes. Why not read a wikibook on Geometry? 



Test your knowledge 

Question 9.3: Throughout the exercise listings above, we have been filling the shapes first and then drawing their outlines. What happens if we do it the other way around? Consider the 
code below. 


public void paint (Graphics graphics) { 
graphics.setColor(Color.red) ; 
graphics. drawRect (10, 10, 100, 100); 

graphics. setColor (Color. yellow) ; 
graphics . f i URect (10 , 10, 100, 100); 


1. The left and the top outlines disappear. 

2. The right and the bottom outlines disappear. 

3. The color for the outline becomes the color for the fill area. 

4. All the outlines disappear. 

Answer 

All the outlines disappear. 

Question 9.4: What would drawLine (io, ioo, ioo, ioo)giveyou? 

1. A horizontal line. 

2. A vertical line. 

3. A diagonal line. 

Answer 

A horizontal line. 


If you have any questions regarding the content provided here, please feel free to comment in this page's discussion. 

External Links 

■ Locate the Graphics dass in the online Java API documentation (http://java.sun.eom/j2se/l.4.2/docs/api/java/awt/Graphics.html) 

■ Locate the Color dass in the online Java API documentation (http://java.sun.eom/j2se/l.4.2/docs/api/java/awt/Color.html) 


Graphics/Drawing complex shapes 


Code listing 9.4: Drawing complex shapes 


public dass Hello { 

JLabel label = newJLabel( "Hello, Mundo!"); 

JFrame frame = new JFrarae( "BK*" ); 
frame. add (label); 

frame. setSize (300, 300); 

frame.set DefaultCloseOperat Ion (JFrame. EXIT_ON_CLOSE ); 

frame. setVisible (true) ; 

frame. setLocationRelativeTo (null) ; 

frame. toFront (); 

} 
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Graphics/Drawing text 

Code listing 9.5: Drawing text 


public dass MyCanvas extends Canvas { 
public void init() { 

setFont ("Times New Roman", Font.PLAIN, 24); 
setColor(Color. white) ; 
setBackGroundColor(Color. black) ; 
setLayout (new GridLayout); 

add(label); 
add(button); 

} 

} 


Applets 

■ OverView 

■ User Interface 

■ Event Listeners 

■ Graphics and Media 


Applets/Overview 

A Java applet is an applet delivered in the form of Java bytecode. Java applets can run in a Web browser using a Java Virtual Machine (JVM), or in Oracle's Applet Viewer, a stand alone tool 
to test applets. Java applets were introduced in the first Version of the Java language in 1995. Java applets are usually written in the Java programming language but they can also be written 
in other languages that compile to Java bytecode such as Jython. 

Applets are used to provide interactive features to web applications that cannot be provided by HTML. Since Java's bytecode is platform independent, Java applets can be executed by 
browsers for many platforms, including Windows, Unix, Mac OS and Linux. There are open source tools like applet2app which can be used to convert an applet to a stand alone Java 
apphcation/windows executable. This has the advantage of running a Java applet in off-line mode without the need for Internet browser Software. 

The Java applet is less and less used. You'd rather use JavaScript when it is possible. 

First applet 

The two things you must at least create is an HTML page and a Java dass. It can be done on a local folder, no need to run a Server but it will be harder to understand what is local, what is 
remote. The HTML page has to call the Java dass using the <appiet/> markup: 

Code listing 9.3: HelloWorld.html 


1 < ! DOCTYPE html> 

2 <html> 

3 <body> 

4 HTML content before the applet. <applet code^ "HelloWorld" height^"40" width= "200" ></applet>HTML content after the apple 

5 </body> 

6 </html> 


Save this file on a folder. As the <appiet/> markup is calling a Java dass called HelloWorld, our dass should be called HelloWorld. java: 

Code listing 9.4: HelloWorld.java 

,- 1 

i i 

1 1 Import java.applet.Applet; 1 

1 2 Import java.awt.Graphics ; 1 

| 3 | 

' 4 public dass HelloWorld extends Applet { j 


i 5 ; 

| 6 /** | 

i 7 * Print a message on the screen. ! 

; 8 v ; 

i 9 public void paint (Graphics g) { , 

110 g. drawString ( "Hello, world!", 20, l] 

111 } I 

112 } I 

l_i 


Save this file and compile the dass on the same folder. Now let's open the web page on a browser: 
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We clearly see that "Hello, world!" is not rendered the same way as the rest of the page. 

HTML code 


See also applet markup. 

To embed an applet in a HTML page, you have to insert a <appiet/> markup. This markup can have several attributes: 


code* 

The name of the main dass to call. It could be the name of the dass with or without the .dass . 

height 

The height of the area where the content of the applet can be rendered on the web page. 

width 

The width of the area where the content of the applet can be rendered on the web page. 

archive 

The name of a compressed zip archive having . jar extension. The archive can contain all the needed classes to run the applet. Applets are usually delivered in this form, to 
minimize the download time. 


The attributes with * are mandatory. 

There have been some discussions about the usage of applet tag but it still can be used for beginning and also would work in the real world as well. 

Java source code 

Applets are not constructed in the same way as other classes or main programs. The entry point is different and the main dass should extend the Applet dass. The Applet dass has four 
methods that can be called by the browser and you can redefine: 


init () 

Called when the browser first loads the applet. It is only called once by browser execution. 

Start() 

Called when the applet Starts running. It is called as many times as the user visits the web page. 

stop() 

Called when the applet stops running. It is called as many times as the user visits the web page. 

destroy() 

Called when the user quits the browser. It is only called once by browser execution. 

paint () 

Called when the applet needs to be rendered, for example, when the browser is resized. 


The four first methods define the lifecycle of an applet. At least init () or paint () must be redefined. The HTML applet tag can be embedded in the applet source code to allow the applet 
to be run directly by a simple applet viewer, without the need for an .html file. Typically, the applet tag immediately follows the import Statements. It must be enclosed by /* */ comments: 

Code section 9.10: MyApplet comment 


1 /* 

2 <applet code="MyApplet.dass"> </applet> 

3 */ 



Applets/User Interface 

The main difference between an applet and a regulär command-line executed program is that applets allow for extensible Graphical User Interfaces (GUI). 

Since applets provide for the ability to create complex GUI, it is important for developers to know how to create such programs. 

Applying styles and adding content 

In Java applets, graphical portions are initialized and added in two different areas. While objects are initialized in the main dass, they are added to the layout of the applet in the init () 
method. This is done using the syntax of add (<object>) . A typical init () method looks something like this: 

Code section 9.8: A typical init () method 


1 ... 

2 

3 public void init() { 

4 setFont (new Font ("Times New Roman", Font.PLAIN, 24 

5 setForeground(Color. white) ; 

6 setBackground(Color. black ); 

7 setLayout (new GridLayout); 

8 
9 

10 

11 add(label); 

12 add(button); 

13 } 



The different aspects of this method will be covered below. 

Button 
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Lots of applets use buttons. There are only a few ways to have contact between the applet and the user, and the use of buttons is one of those ways. Buttons are created the same way as 
most other Java applet objects: 

Code section 9.9: Button creation 


i i 


■1 Button submitButton = new Button (" Submit "); 1 




When initializing a button, it is necessary to define what text will appear on that button in the given parameter. In this example, the button is initialized with the word "Submit" printed on it. 
Adding the button to the actual layout is done in the init () method, as described above. 

Code section 9.10: Button display 

i-1 

■ i 

il public void init() { i 

'2 1 

i 

'3 1 

■ i 

i4 i 

|5 add (submitButton) ; | 

'6 } ' 

■ i 



Allowing buttons to carry out tasks or utilize a user's input is a bit more complicated. These functions require an ActionListener, and will be discussed in ActionListener section. 


Label 


Labels are areas in applets that contain text which can not be edited by the user. This is usually ideal for descriptions (i.e. "Insert name:"). Labels are initialized and added to applet layouts 
in the same way as buttons. Also, like buttons, the text inside labels must be identified at initialization. If, however, the label will receive its text as the cause of a later function and should 
Start off blank, no text should be placed between the quotation marks. 



Code section 9.11: Label display 


'1 Label nameLabel = new Label ("Name: "); 

i2 

|3 ... 

'4 

i 

i5 public void init() { 

|6 add(nameLabel); 

'7 } 

■ 


TextField 


TextFields are areas in applets that allow users to insert text. The two parameters, which are optional, for TextFields can set predefined text in the field or set the number of columns allowed 
in the TextField. Here are a few examples: 




Code section 9.12: Text field creation 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 


TextField tl = new 
TextField t2 = new 
TextField t3 - new 
TextField t4 = new 


TextField(); 

TextField(5); 

TextField (" Input here") ; 
TextField (" Input here", 5); 


// Blank 

// Blank in 5 columns 
// Predefined text 
// Predefined text in 5 colu 


public void init() { 
add(tl); 
add(t2); 
add (t3); 
add(t4); 


} 


Font 

Using stylish fonts in your Java applets may be necessary to help keep your Java applets attractive. The setFont () allows for either the font used throughout the applet to be defined or for 
one element's font to be set at a time. 

The Syntax for setting a font is setFont (<fontName>, <fontStyle>, <fontSize >). 

To make every font in the applet plain, size 24 Times New Roman, the following code should be used: 

Code section 9.13: Font setting 


jl Font f = new Font ("Times New Roman", Font. PLAIN, 24); 
'2 setFont (f) ; 

L_ 


It is not necessary to initialize the font and set the font through two different lines of code. 



Code section 9.14: Direct font setting 



'1 setFont (new Font ("Times New Roman", Font. PLAIN, 2 4) ) ; i 



However, to make the font of element a plain, size 24 Times New Roman, and element b italicized, size 28 Times New Roman, the following code should be used: 

Code section 9.15: Object font setting 

jl a. setFont (new Font ("Times New Roman", Font. PLAIN, 24)); i 
'2 b. setFont (new Font ("Times New Roman", Font. ITALIC, 28) ); j 
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To set the color of the fonts used in an applet, the setForeground (<coior>) method is used. This method already includes some predefined colors which can be used by calling, for 
example, setForeground (Color . white) . Here are all of the predefined colors: 

■ Color.black 

■ Color.blue 

■ Color.cyan 

■ Color.darkGray 

■ Color.gray 

■ Color.green 

■ Color.red 

■ Color.white 

■ Color.yellow 

To create a custom color, the RGB values of the color can be passed in as the color parameter. For example, if red were not a predefined color, one could use setForeground (new 
Color (255, o, o )) to define red. 

Just as font styles, font colors can be applied to separate elements. The syntax follows the same pattern: a. setForeground (Color .white). 

Layout 

Layouts are what make applets visible. Without a layout, nothing would display. There are five different types of layouts to choose from — some are very simple while others are complex. 

Flow Layout 

This layout places components left to right, using as much space as is needed. The Flow Layout is the default layout for applets and, therefore, does not need to be set. However, for clarity, 
one can specify the applet layout as a Flow Layout by placing this line of code at the top of the init () method: 

Code section 9.16: Flow Layout 

i- 1 

i i 

■1 setLayout (new FlowLayout ()); i 

i i 

L-1 


The added components to the layout that follow will be placed on screen in order of which they are added. 



Code section 9.17: Component display 

I-! 

l l 

il public void init() { i 

|2 setLayout (new FlowLayout ()); J 

'3 add (nameLabel) ; 1 

U add(tl); ! 

|5 add (submitButton) ; ’ 

'6 } 

I I 

I_I 


Assuming that these variables are defined the same as above, these lines of code will create the layout of an applet that is composed of a label, a text field, and a button. They will all appear 
on one line if the window permits. By changing the width of window, the Flow Layout will contract and expand the components accordingly. 


Grid Layout 

This layout arranges components in the form of the table (grid). The number of rows and columns in the grid is specified in the constructor. The other two parameters, if present, specify 
vertical and horizontal padding between components. 


Code listing 9.4: GridLayoutApplet.java 


1 Import java.applet.Applet; 

2 Import java.awt.Button; 

3 Import java.awt.GridLayout; 

4 Import java.awt.Label ; 

5 Import java.awt.TextField; 

6 

7 public dass GridLayoutApplet extends Applet { 


9 Button submitButton = new Button (" Submit ") ; 

10 TextField tl = new TextField(); 

11 TextField t2 = new TextField(5); 

12 TextField t3 = new TextField (" Input here") ; 

13 TextField t4 = new TextField (" Input here", 5); 

14 Label nameLabel = new Label ("Name: "); 

15 

16 /** 

17 * Init. 

18 */ 

19 public void init() { 

20 // 3 rows, 4 columns, 2 pixel spacing 

21 setLayout (new GridLayout (3, 4, 2, 2)); 

22 add(nameLabel); 

23 add(tl) ; 

24 add(t2); 

25 add(t3); 

26 add(t4); 

27 add(submitButton); 

28 } 

29 } 


// Blank 

// Blank in 5 columns 
// Predefined text 
// Predefined text in 5 columns 


The items have been displayed in this order: 


l st 

2 nd 


3 th 

4_th 


5 th 

6 th 



We see that the layout has been configured to fill the grid left-to-right and then top-to-bottom and that the two last columns have been ignored (they don't even exist). They have been 
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ignored because there are not enough items to fill them and the number of rows is prior to the number of columns. This means that when you specify a number of rows that is not zero, the 
number of columns is simply ignored. You should specify zero rows in order that the number of columns is taken into account. 

A grid layout creates cells with equal sizes. So it can be used not only to display items as a grid but also to display two items with the same width or height. 


B order Layout 


This layout places one big component in the center and up tili four components at the edges. When adding to the Container with this layout, you need to specify the location as the second 
Parameter like BorderLayout. center for the center or one of the world directions for the edge (BorderLayout .north points to the top edge). 



Code section 9.19: Border layout 

I-1 


1 Import java.awt.*; 

2 

3 Container Container = getContentPane (); 

4 Container. setLayout (new BorderLayout()) 

5 

6 JButton b2 = new JButton ("two") ; 

7 // Add the button to the right edge. 

8 Container. add (b2, BorderLayout. EAST ); 

9 ... 


L 


-I 


If you have two components, it is not the same to put the first in the north and the second to the center as to put the first in the center and the second to the south. In the first case, the layout 
will calculate the size of the component and the second component will have all the space left. In the second case, it is the opposite. 


Card Layout 


The card layout displays only one item at a time and is only interesting with interactivity. The other items are stored in a stack and the displayed item is 
one of the items of the stack. The name of the card layout is a reference to a playing card deck where you can see the card at the top of the stack and 
you can put a card on the top. The difference in the card layout is that the items in the stack keeps their order. When you use this layout, you must use 
this method to add items to the Container, i.e. the applet: 


void add (String itemld, 


Component item) 


Adds an item to the Container and associate the item to the id. 


The card layout has several methods to change the currently displayed item: 


void first (Container Container) 

Display the first item of the stack. 

void next (Container Container) 

Display the item of the stack that is located after the displayed item. 

void previous(Container Container) 

Display the item of the stack that is located before the displayed item. 

void last (Container Container) 

Display the last item of the stack. 

void show(Container Container, String itemld) 

Display an item by its id. 



Code listing 9.5: CardLayoutApplet.java 


1 Import java.applet.Applet ; 

2 Import java.awt . CardLayout ; 

3 Import java.awt . Label; 

4 

5 public dass CardLayoutApplet extends Applet { 

6 

7 static final String COMPONENT_POSITION_TOP = "TOP"; 

8 static final String COMPONENT_POSITION_MIDDLE = "MIDDLE"; 

9 static final String COMPONENT_POSITION_BOTTOM = "BOTTOM"; 

10 

11 Label topLabel = new Label ("At the top"); 

12 Label middleLabel = new Label ("In the middle"); 

13 Label bottomLabel = new Label ("At the bottom"); 

14 

15 /** 

16 * Init. 

17 */ 

18 public void init() { 

19 setLayout (new CardLayout ()); 

20 add(COMPONENT_POSITION_TOP, topLabel); 

21 add(COMPONENT_POSITION_MIDDLE, middleLabel); 

22 add(COMPONENT_POSITION_BOTTOM, bottomLabel); 

23 ( (CardLayout)getLayout() ) ,show(this, COMPONENT_POSITION_MIDDL 

24 } 

25 } 


Panel 

The main benefit of the layouts is that you can combine them one into another and you can do that with a panel. A panel is a component that has other components inside. A panel can then 
be added to the top component (frame or applet) or to another panel and be placed itself as defined by layout and constraints of this parent component. It has its own layout and is normally 
used to place a group of related components like buttons, for instance: 
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Figure 9.16: Java applet example. 


Test your knowledge 
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Quesdon 9.5: We want to create a basic FTP (File Transfer Protocol) Software which looks like this: 


Application name 

Tool 

Tool 

Tool| Tool| Tool| Tool| Tool| 

Tool 

Tool 


Local folder 


Remote folder 

Status bar 


On the top, it should display the name of the Software. Under the name, it should display tool buttons that are displayed from the left to the right and the sequence of buttons is wrapped if 
it reaches the right border. Under the buttons, it should display two lists of files. The widths of these two lists should be the same and they should use all the width of the application. 

Under these two lists, it should display a Status bar. 

Create this display on an applet. 


Answer 

First, we have to analyze the display. We have four separate areas of components: 

■ The name area 

■ The tool area 

■ The folder area 

■ The Status area 

So we have to first separate these areas and then we will split these areas into components. 


Answer 9.5: Answer5.java 


r 


1 Import 

2 Import 

3 Import 

4 Import 

5 Import 

6 Import 

7 Import 


java.applet.Applet; 
java.awt.BorderLayout; 
java.awt.Button; 
java.awt.FlowLayout ; 
java.awt.GridLayout; 
java.awt.Label ; 
java.awt.Panel ; 


l 


9 public dass Answer5 extends Applet { 


.10 , 

.11 Label applicationNameLabel = new Label( "Wikibooks FTP"); . 

.12 Button toollButton = new Button ("Tool") ; . 

.13 Button tool2Button = new Button ("Tool") ; i 

■14 Button tool3Button = new Button ("Tool") ; i 

'15 Button tool4Button = new Button ("Tool") ; i 

'16 Button tool5Button = new Button ("Tool") ; ■ 

'17 Button tool 6 Button = new Button ("Tool") ; 1 

'18 Button tool7Button = new Button ("Tool") ; 1 

[19 Button tool 8 Button = new Button ("Tool") ; 1 

[20 Button tool9Button = new Button ("Tool") ; | 

[21 Label localFolderLabel = new Label ("5 files"); j 

[22 Label remoteFolderLabel = new Label ("3 files"); j 

,23 Label statusBarLabel = new Label( "Available" ); j 

|2 4 | 

|25 /** I 

'i2 6 * Ini t . | 

i2 7 */ | 

.28 public void init () { . 

.2 9 setLayout (new BorderLayout ()) ; . 

6 0 ! 
.31 // The application name i 

'32 add(applicationNameLabel, BorderLayout. NORTH ); i 

'33 « 

'34 // The Center ' 

'35 Panel centerPanel = new Panel (); 1 

'36 centerPanel. setLayout (new BorderLayout ()); 1 

|37 | 

[38 // The buttons j 

[39 Panel buttonPanel = new Panel (); 1 

,40 buttonPanel. setLayout (new FlowLayout(FlowLayout.LEFT));j 

,41 buttonPanel. add (toollButton); ] 

[4 2 buttonPanel. add (tool2Button); J 

,43 buttonPanel. add (tool3Button); , 

.44 buttonPanel. add (tool4Button); | 

.45 buttonPanel. add (tool5Button); , 

.46 buttonPanel. add (tool 6 Button); , 

.47 buttonPanel. add (tool7Button); 1 

'48 buttonPanel. add (tool 8 Button); 1 

'49 buttonPanel. add (tool9Button); 1 

'50 centerPanel. add (buttonPanel, BorderLayout. CENTER) ; 1 

'51 ' 

'52 // The local and remote folders ' 

'53 Panel folderPanel = new Panel (); ' 

'54 folderPanel. setLayout (new GridLayout ( 0, 2, 2, 2)); ' 

[5 5 folderPanel. add (localFolderLabel); ! 

[5 6 folderPanel. add (remoteFolderLabel); ! 

[5 7 centerPanel. add (folderPanel, BorderLayout. SOUTH) ; j 

|5 8 I 

[59 add(centerPanel, BorderLayout. CENTER) ; ] 

|60 I 

]61 // The Status bar | 

.62 add(statusBarLabel, BorderLayout. SOUTH) ; | 

.63 } ! 

16 4 } ! 

I_I 


1. The totality of the components is put in a border layout so that we have three vertical areas of elements. 

2. The area in the north is the area of the title. 

3. The area in the center contains the buttons and the folders and will be split later. 
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4. The area in the south is the area of the Status bar. 

5. The area in the center is now split with a border layout into a button area in the center and a folder area in the south. 

6. The button area is then split with a flow layout. 

7. The folder area is now split with a grid layout. 

We use a grid layout to display the folders to have the same width between the two components. We can't use a grid layout to separate the name, the buttons, the folders and the Status 
bar as these areas have not the same height. The buttons must be at the center of the border layout as the number of row of buttons would be badly calculated and the last rows of 
buttons would not appear. 


Applets/Event Listeners 

An Event Listener, once set to an applet object waits for some action to be performed on it, be it mouse click, mouse hover, pressing of keys, click of button, etc. The dass you are using 
(e.g. JButton, etc.) reports the activity to a dass set by the dass using it. That method then decides on how to react because of that action, usually with a series of if Statements to determine 
which action it was performed on. source . getSource () will return the name of the object that the event was performed on, while the source is the object passed to the function when the 
action is performed. Every single time the action is performed, it calls the method. 

ActionListener 

ActionListener is an interface that could be implemented in order to determine how certain event should be handled. When implementing an interface, all methods in that interface should 
be implemented, ActionListener interface has one method to implement named actionPerformed (). 

The code listing 9.6 shows how to implement ActionListener: 

Code listing 9.6: EventApplet.java 

I-^ 

I I 

1 1 Import java.applet.Applet; 1 

1 2 Import java.awt.Button; 1 

1 3 Import java.awt.Container; 1 

| 4 Import java.awt.Dialog; [ 

| 5 Import java.awt.FlowLayout; [ 

| 6 Import java.awt.Frame; [ 

, 7 Import java.awt.Label; ] 

i 8 Import java.awt.event.ActionEvent ; J 

i 9 Import java.awt.event.ActionListener; , 

■ i 

110 , 

i i 

111 public dass EventApplet extends Applet { i 


11 2 i 

Il3 /** ! 

■ 14 * Ini t . i 

'15 */ ! 

'16 public void init() { ' 

'17 Button clickMeButton = new Button( "Click me"); 1 

'18 ' 
'19 final Applet eventApplet = this; 1 

| 2 ° | 

[21 ActionListener specificClassToPerformButtonAction = new ActionListener(' 

[2 2 | 
[23 public void actionPerformed (ActionEvent event) { [ 

,24 Dialog dialog = new Dialog(getParentFrarae(eventApplet), false);[ 

,25 dialog. setLayout (new FlowLayout ()); , 

',2 6 dialog . add (new Label ( "Hi !!!")) ; [ 

127 dialog. pack () ; , 

128 dialog. setLocation (100, 100); ! 

12 9 dialog. setVisible (true) ; i 

ho } ! 

hl ! 

'32 private Frame getParentFrame (Container Container) { i 

'33 if (Container == null) { ' 

'3 4 return null; ' 

'35 } eise if (Container instanceof Frame) { 1 

'36 return (Frame) Container; 1 

[37 } eise { [ 

[38 return getParentFrame(Container. getParent ()); 1 

[3 9 } ; 

[4° ; 

[4i j ; 

|4 2 }; [ 

,43 clickMeButton. addActionListener (specificClassToPerformButtonAction); [ 

*4 4 [ 

i45 add(clickMeButton); ! 

i4 6 } ! 

147} ! 

L_1 


When you compile and run the above code, the message "Hi!!!" will appear when you click on the button. 

MouseListener 

Applet mouse listener does not differ from the AWT mouse listener in general. When the mouse is in the applet area, the listener receives notifications about the mouse clicks and drags (if 
MouseListener is registered) and mouse movements (if MouseMotionListener is registered). As applets are often small, it is a common practice to let applet itself to implement the mouse 
listeners. 


Applets/Graphics and Media 

Painting 
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By overriding the update (Graphics g) and paint (Graphics g) methods of an Applet (or one of it's sub-components), you can have fairly direct control over the rendering of an Applet. 
The Graphics object provides various primitives for working for two-dimensional graphics. 


Reflection 


Reflection is a new concept in Java, and did not exist in classical compiled languages like C, and C++. The idea is to discover an object's attributes and its methods programmatically. 


Reflection/Overview 


Reflection is the mechanism by which Java exposes the features of a dass during runtime, allowing Java programs to enumerate and access a dass' methods, fields, and constructors as 
objects. In other words, there are object-based mirrors that reflect the Java object model, and you can use these objects to access an object's features using runtime API constructs instead 
of compile-time language constructs. Each object instance has a getciass () method, inherited from java. lang. object, which returns an object with the runtime representation of that 
object's dass; this object is an instance of the java. lang. ciass, which in turn has methods that return the fields, methods, constructors, superclass, and other properties of that dass. You 
can use these reflection objects to access fields, invoke methods, or instantiate instances, all without having compile-time dependencies on those features. The Java runtime provides the 
corresponding classes for reflection. Most of the Java classes that support reflection are in the java. lang. reflect package. Reflection is most useful for performing dynamic operations 
with Java — operations that are not hard-coded into a source program, but that are determined at run time. One of the most important aspects of reflection is dynamic dass loading. 


Example: Invoking a main method 

One way to understand how reflection works is to use reflection to model how the Java Runtime Environment (JRE) loads and executes a dass. When you invoke a Java program 



java fuLLy-quaLified-cLass-name arg 0 ... arg n 


and pass it command line arguments, the JRE must 

1. put the command line arguments argo ... arg n into a string[] array 

2. dynamically load the target dass named by fully-qualified-class-name 

3. aCCeSS the public static void main (String [ ] ) method 

4. invoke the main method, passing the string array main string [ ]. 

Steps 2, 3, and 4 can be accomplished with Java reflection. Below is an example of loading the Distance dass, locating the main method, (see Understanding a Java Program) and invoking 
it via reflection. 

Code section 10.1: main() method invocation. 


1 public static void invokeMain () 

2 throws ClassNotFoundException, 

3 ExceptionlnlnitializerError, 

4 UlegalAccessException, 

5 IllegalArgumentException, 

6 InvocationTargetException, 

7 NoSuchMethodException, 

8 SecurityException { 

9 Class<?> distanceClass = dass. forName ( "Distance" ); 

10 String[] points = {"0", "0", "3", "4"}; 

11 Method mainMethod = distanceClass . getMethod ( "main" , String[] .das 

12 Object result = mainMethod. invoke (null , (Object) points); 

13 } 



This code is obviously more complicated than simply calling 

Code section 10.2: main() method calling. 


i i 

'1 Distance. main (new String []{" 0 " , "0", "3", "4" });■ 

i i 



However, the main Java runtime does not know about the Distance dass. The name of the dass to execute is a runtime value. Reflection allows a Java program to work with classes even 
though the classes are not known when the program was written. Let's explore what the invokeMain method is doing. The first Statement at line 9 is an example of dynamic dass loading. 
The forName () method will load a Java dass and return an instance of java. lang. ciass that results from loading the dass. In this case, we are loading the dass "Distance" from the 
default package. We störe the dass object in the local variable distanceClass; its type is ciass<?>. The second Statement at line 10 simply creates a string array with the four command 
line arguments we wish to pass to the main method of the Distance dass. The third Statement at line 11 performs a reflection Operation on the Distance dass. The getMethod () method is 
defined for the ciass dass. It takes a variable number of parameters: the method name is the first parameter and the remaining parameters are the types of each of main's parameters. The 
method name is trivial: we want to invoke the main method, so we pass in the name "main". We then add a ciass variable for each of the method parameters. main accepts one parameter 
(string [ ] args) so we add a single ciass element representing the String[]. The getMethod method has a return type of java. lang, reflect .Method; we störe the result in a local 
variable named mainMethod. Finally, we invoke the method by calling the invoke () method of the Method instance. This method's first parameter is the instance to invoke on, and the 
remaining parameters are for the invokee's parameters. Since we are invoking a static method and not an instance method, we pass null as the instance argument. Since we only have a 
single parameter we pass it as the second argument. However, we must cast the parameter to Object to indicate that the array is the parameter, and not that the parameters are in the array. 
See varargs for more details on this. 

Code section 10.3: invoke() call. 

,- 1 

i i 

■1 Object result = mainMethod. invoke (null , arguments);i 

i i 

i-1 



The invoke ( ) method returns an object that will contain the result that the reflected method returns. In this case, our main method is a void method, so we ignore the return type. Most of 
the methods in this short invokeMain method may throw various exceptions. The method declares all of them in its signatures. Here is a brief rundown of what might throw an exception: 

■ Ciass . forName (String) will thrOW ClassNotFoundException, if the named claSS Cannot be located. 

■ ciass . forName (string) will throw ExceptionlnlnitializerError, if the ciass could not be loaded due the static initializer throwing an exception or a static field's initialization 
throwing an exception. 

■ Ciass . getMethod (String name, Ciass parameterTypes [ ] ) will thrOW 
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■ NoSuchMethodException, if a matching method is not found, or is not public (use getDeciaredMethod to get a non-public method). 

■ SecurityException, if a security manager is installed and calling the method would result in an access violation (for example, the method is in the sun . * package designed for 
internal use only). 

■ Method.invoke(Object instance, Object... arguments) may thrOW! 

■ niegaiAccessException, if this method is invoked in a manner that violates its access modifiers. 

■ niegaiArgumentException for various reasons, including 

■ passing an instance that does not implement this method. 

■ the actual arguments do not match the method's arguments 

■ invocationTargetException, if the underlying method (main in this case) throws an exception. 

In addition to these exceptions, there are also errors and runtime exceptions that these methods may throw. 


Reflection/Dynamic Class Loading 

Dynamic Class Loading allows the loading of java code that is not known about before a program Starts. Many classes rely on other classes and resources such as icons which make loading 
a single class unfeasible. For this reason the ciassLoader (java. lang. ciassLoader) is used to manage all the inner dependencies of a collection of classes. The Java model loads classes 
as needed and need not know the name of all classes in a collection before any one of its classes can be loaded and run. 

Simple Dynamic Class Loading 

An easy way to dynamically load a ciass is via the java. net. URLCiassLoader class. This class can be used to load a ciass or a collection of classes that are accessible via a URL. This is 
very similar to the -ciasspath parameter in the java executable. To create a URLCiassLoader, use the factory method (as using the constructor requires a security privilege): 

Code section 10.4: Class loader. 


jl URLCiassLoader ciassLoader = URLCiassLoader. newlnstance ( 

'2 new URL[] {"http://example.com/javaClasses.jar"}) ; 

■ 



Unlike other dynamic class loading techniques, this can be used even without security permission provided the classes come from the same Web domain as the caller. Once a ciassLoader 
instance is obtained, a class can be loaded via the loadciass method. For example, to load the class com.example .Myciass, one would: 



Code section 10.5: Class loading. 



'1 Class<?> clazz = ciassLoader. load (" com . example . MyClass "); i 



Executing code from a ciass instance is explained in the Dynamic Invocation chapter. 


Reflection/Dynamic Invocation 


We Start with basic transfer object: 


Code listing 10.1: DummyTo.java 


i i 
! 2 
! 3 
I 4 
' 5 
' 6 

I 7 

! 8 
! 9 

! 10 

|n 

I 12 

|l 3 
Jl 4 
\l5 

Il6 

II 7 
!l 8 

11 9 

12 0 
i21 
'2 2 
'2 3 
'2 4 
|2 5 

! 26 
|2 7 

|2 8 
|2 9 
|3 0 
|31 
|32 

13 3 
i3 4 
i35 
i3 6 


package com.test; 

public class DummyTo { 

private String name; 
private String address; 

public String getName () { 

return name; 

} 

public void setName (String name) { 
this .name = name; 

} 

public String getAddressO { 
return address; 

} 

public void setAddress (String address) { 
this. address = address; 

} 

public DummyTo (String name, String address) { 
this .name = name; 
this. address = address; 

} 

public DummyTo () { 

this. name = new String (); 
this. address = new String(); 

} 

public String toString (String appendBefore) { 

return appendBefore + " " + name + ", " + address; 

} 


L_! 


Following is the example for invoking method from the above mentioned to dynamically. Code is seif explanatory. 

Code listing 10.2: ReflectTest.java 

1 ! 

| 1 package com.test; ' 



Console for Code listing 10.2 


il am Java Programmer, India 

i 

l_ 


l 
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2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 


Import java.lang.reflect.Constructor; 

Import java.lang.reflect.InvocationTargetException; 

Import java.lang.reflect.Method; 

public dass ReflectTest { 

public static void main (String[] args) { 

try { 

Class<?> dummyClass = dass. forName ("com. test .DuramyTo") ; 

// parameter types for methods 

Class<?>[] partypes = new dass []{ String . dass } ; 

// Create method object. methodname and parameter types 
Method meth = dummyClass. getMethod ( "toString" , partypes); 

// parameter types for constructor 

Class<?>[] constrpartypes = new dass []{ String . dass , String . dass } ; 
//Create constructor object. parameter types 

Constructor<?> constr = dummyClass. getConstructor (constrpartypes) ; 

// create instance 

Object dummyto = constr. newlnstance (new Object[]{ " Java Programmer", 

// Arguments to be passed into method 
Object[] arglist = new Object []{"I am"} ; 

// invoke method!! 

String output = (String) meth. invoke (dummyto, arglist); 

System.out. printin (output); 

} catch (ClassNotFoundException e) { 
e.printStackTrace (); 

} catch (SecurityException e) { 
e.printStackTrace (); 

} catch (NoSuchMethodException e) { 
e.printStackTrace (); 

} catch (IllegalArgumentException e) { 
e.printStackTrace (); 

} catch (IllegalAccessException e) { 
e.printStackTrace (); 

} catch (InvocationTargetException e) { 
e.printStackTrace (); 

} catch (InstantiationException e) { 
e.printStackTrace (); 

} 

} 

} 


"India"} ); 


Conclusion: Above examples demonstrate the invocation of method dynamically using reflection. 


Reflection/Accessing Private Features with Reflection 

All features of a dass can be obtained via reflection, including access to private methods & variables. But not always see [6] (http://www.onjava.eom/pub/a/onjava/2003/ll 
/12/reflection.html). Let us look at the following example: 

Code listing 10.3: Secret.java 


1 public dass Secret { 

2 private String secretCode = "It's a secret"; 

3 

4 private String getSecretCode () { 

5 return secretCode; 

6 } 

7 } 


Although the field and method are marked private, the following dass shows that it is possible to access the private features of a dass: 


Code listing 10.4: Hacker.java 

i -1 

1 1 Import java.lang.reflect.Field; 1 

1 2 Import java.lang.reflect.InvocationTargetException; 1 

| 3 import java.lang.reflect.Method; 1 

| 4 | 

| 5 public dass Hacker { [ 

I 6 | 

| 7 private static final Object[] EMPTY = {}; j 

I 8 ; 

i 9 public void reflect () throws IllegalAccessException, IllegalArgumentException, InvocationTargetException {, 

110 Secret instance = new Secret(); , 

111 Class<?> secretClass = instance. getClass (); i 

11 2 ! 

■13 // Print all the method names & execution result i 

>14 Method methods[] = secretClass. getDeclaredMethods (); i 

'15 System. out . println ( "Access all the methods"); ■ 

'16 for (Method method : methods) { 1 

'17 System. out . println ( "Method Name: " + method. getName ()); 1 

'18 System. out . println ( "Return type: " + method. getReturnType ()); 1 

'19 method. setAccessible (true) ; 1 

'20 System. out . println (method. invoke (instance, EMPTY) + "\n"); 1 

| 21 } | 

|2 2 | 

,23 // Print all the field names & values j 

,24 Field fields[] = secretClass. getDeclaredFields (); [ 

,25 System. out . println ( "Access all the fields"); , 

12 6 for (Field field : fields) { | 



Console for 


Code listing 10.4 


,- 1 

,Access all the methods 1 

,Method Name: getSecretCode 1 

,Return type: dass java . lang . String 1 

,1t' s a secret ' 

lAccess all the fields ' 

iField Name: secretCode [ 

ilt' s a secret j 

i_, 
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■27 System. out . println ( "Field Name: " + field. getName ()); 

'28 field. setAccessible (true) ; 

'29 System. out . println (field. get (instance) + "\n"); 

|3 0 } 

|31 } 

[3 2 

[33 public static void main (String[] args) { 

[34 Hacker newHacker = new Hacker(); 

[35 

[3 6 try { 

,37 newHacker. reflect (); 

,38 } catch (Exception e) { 

i39 e . printStackTrace () ; 

i4 0 } 

|41 } 

i4 2 } 


JUnit - Test Private methods 

JUnit's are unit test cases, used to test the Java programs. Now you know how to test a private method using Reflection in JUnit. There's a long-standing debate on whether testing private 
members is a good habit^^There are cases where you want to make sure a dass exhibited the right behavior while not making the fields that need checking to assert that public (as it's 
generally considered bad practice to create accessors to a dass just for the sake of a unit test). There are also cases when you can greatly simplify a test case by using reflection to test all 
smaller private methods (and their various branches), then test the main function. With dp4j (http://dp4j.com) it is possible to test private members without directly using the Reflection API 
but simply accessing them as if they were accessible from the testing method; dp4j injects the needed Reflection code at compile-time^J 

1. What's the best way of unit testing private methods? (http://stackoverflow.com/questions/34571/whats-the-best-way-of-unit-testing-private-methods), March 7, 2011 

2. Reflection API injected at compile-time (http://dp4j/faq) 


Advanced topics 
Networking 

Prior to modern networking Solutions there existed Workstations that were connected to a massive Mainframe Computer that was solely responsible for memory management, processes and 
almost everything. The Workstations would just render the information sent in from the Mainframe console. 

But in the mid 90's, with the prices of Unix Servers dropping, the trend was moving away from Mainframe computing toward Client-Server computing. This would enable rieh clients to be 
developed on Workstations while they would communicate with a centralized Server, serving Computers connected to it, to either communicate with other Workstations also connected to it 
or it would request for database access or business logic stored on the Server itself. The Workstations were called clients. 

This form of computing gave rise to the notion of the Front-end and Back-end programming. In it's hey-day, Java came up with different ways of making networking between Computers 
possible. In this chapter, we would be looking at some of these ways. Listed below are two of the frameworks that Java uses to enable network programming. We would be exploring both of 
these in this chapter. 


Client-Server programming 

1. Networking basics 

2. Creating a simple Server 

3. Listening for clients 

4. Creating a client to interact with the Server 

5. Sending information over a network 

6. Building complex carriage routines 


Remote Method Invocation (RMI) 

1. Basics of Remote Method Invocation 

2. Of stubs and proxies 


Database Programming 


Regular Expressions 

The regulär expressions (regex) are provided by the package java. utii. regex. 

Researches 


The Pattern dass offers the function matches which returns true if an expression is found into a string. 
For example, this script returns the unknown word preceding a known word: 


Import java.util.regex.Pattern; 
public dass Regex { 

public static void main (String[] args) { 

String s = "Test Java regex for Wikibooks."; 

System.out. printin (Pattern. matches ( " [a-z] * Wikibooks", s)); 

} 

} 

// Displays: "for Wikibooks" 


The Mat eher dass allows to get all matches for a given expression, with different methods: 

].find(): find the next result. 

2. group (): displays the result. 

For example, this script displays the HTML b tags contents: 
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Import java.util.regex.Pattern; 
Import java.util.regex.Matcher; 


public dass Regex { 

public static void main (String[] args) { 

String s = "Test <i>Java</i> <b>regex</b> for <b>Wikibooks</b> ." ; 
Pattern p = Pattern. compile (" <b>([ A <]+)</b> ") ; 

Matcher m = p.raatcher (s); 
while (m. find ()) { 

System.out .printin (m. group ()); 

System.out .printin (m. group (1)); 

} 

} 

} 

/* Displays: 

<b>regex</b> 

regex 

<b>Wikibooks</b> 

Wikibooks 

*/ 



Replacements 


Libraries 

Libraries, Extensions, and Frameworks 

■ Math and Geometry 

■ Regular Expressions 

■ Security 

■ Input and Output 

■ Logging 

■ Database Connectivity 

■ Zip and Other Archive s 

■ XML 

■ Graphical User Interfaces 

■ Open Source 

■ Struts 

■ Spring framework 


3D Programming 

Although Java comes with the Java 3D library other libraries have been developed over time with similar functionality. Thus, unlike many other areas of Java development explored in this 
book, a Java programmer has a choice to make as to which 3D library to use. 

3D graphics Java libraries 

■ Java 3D 

■ JOGL 

■ JPCT 

■ Light Weight Java Game Library 


Java Native Interface 

The Java Native Interface (JNI) enables Java code running in a Java Virtual Machine (JVM) to call and to be called by native applications (programs specific to a hardware and operating 
System platform) and libraries written in other languages, such as C, C++ and assembly. 

JNI can be used: 

■ To implement or use features that are platform-specific. 

■ To implement or use features that the Standard Java dass library does not support. 

■ To enable an existing application—written in another programming language—to be accessible to Java applications. 

■ To let a native method use Java objects in the same way that Java code uses these objects (a native method can create Java objects and then inspect and use these objects to perform 
its tasks). 

■ To let a native method inspect and use objects created by Java application code. 

■ Lor time-critical calculations or operations like solving complicated mathematical equations (native code may be faster than JVM code). 

On the other hand, an application that relies on JNI loses the platform portability Java offers. So you will have to write a separate implementation of JNI code for each platform and have 
Java detect the operating System and load the correct one at runtime. Many of the Standard library classes depend on JNI to provide functionality to the developer and the user (file I/O, 
sound capabilities...). Including performance- and platform-sensitive API implementations in the Standard library allows all Java applications to access this functionality in a safe and 
platform-independent manner. Only applications and signed applets can invoke JNI. JNI should be used with caution. Subtle errors in the use of JNI can destabilize the entire JVM in ways 
that are very difficult to reproduce and debug. Error checking is a must or it has the potential to crash the JNI side and the JVM. 

This page will only explain how to call native code from JVM, not how to call JVM from native code. 

Calling native code from JVM 

In the JNI framework, native functions are implemented in separate .c or .epp files. C++ provides a slightly simpler interface with JNI. When the JVM invokes the function, it passes a 
jNiEnv pointer, a job ject pointer, and any Java arguments declared by the Java method. A JNI function may look like this: 


-, 

JNIEXPORT void JNICALL Java_ClassName_MethodName i 

(JNIEnv *env, jobject obj) J 

{ | 

/*Implement Native Method Here*/ i 

} ! 


The env pointer is a structure that contains the interface to the JVM. It includes all of the functions necessary to interact with the JVM and to work with Java objects. Example JNI functions 
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are Converting native arrays to/from Java arrays, Converting native strings to/from Java strings, instantiating objects, throwing exceptions, etc. Basically, anything that Java code can do can 
be done using jNiEnv, albeit with considerably less ease. 

On Linux and Solaris platforms, if the native code registers itself as a signal handler, it could intercept signals intended for the JVM. Signal chaining should be used to allow native code to 
better interoperate with JVM. On Windows platforms, Structured Exception Handling (SEH) may be employed to wrap native code in SEH try/catch blocks so as to capture machine 
(CPU/FPU) generated Software interrupts (such as NULL pointer access violations and divide-by-zero operations), and to handle these situations before the interrupt is propagated back up 
into the JVM (i.e. Java side code), in all likelihood resulting in an unhandled exception. 

C++ code 


For example, the following converts a Java string to a native string: 



extern "C" 

JNIEXPORT void JNICALL Java_ClassName_MethodName 


(JNIEnv *env, jobject obj, jstring javaString) 

{ 

//Get the native string from javaString 

const char *nativeString = env->GetStringUTFChars (javaString, 0); 
//Do something with the nativeString 
//DON'T FORGET THIS LINE!!! 

env->ReleaseStringUTFChars(javaString, nativeString); 


} 



The JNI framework does not provide any automatic garbage collection for non-JVM memory resources allocated by code executing on the native side. Consequently, native side code (such 
as C, C++, or assembly language) must assume the responsibility for explicitly releasing any such memory resources that it itself acquires. 


C code 


JNIEXPORT void JNICALL Java_ClassName_MethodName 
(JNiEnv *env, jobject obj, jstring javaString) 

{ 

/*Get the native string from javaString*/ 

const char *nativeString = (*env)->GetStringUTFChars (env, javaString, 0); 

/*Do something with the nativeString*/ 

/*DON'T FORGET THIS LINE!!!*/ 

(*env)->ReleaseStringUTFChars(env, javaString, nativeString); 

} 


Note that C++ JNI code is syntactically slightly cleaner than C JNI code because like Java, C++ uses object method invocation semantics. That means that in C, the env parameter is 
dereferenced using ( *env) -> and env has to be explicitly passed to JNiEnv methods. In C++, the env parameter is dereferenced using env-> and the env parameter is implicitly passed as 
part of the object method invocation semantics. 

Objective-C code 


, JNIEXPORT void JNICALL Java_ClassName_MethodName (JNiEnv *env, jobject obj, jstring javaString) 

| { 

! / *DON'T FORGET THIS LINE!!!*/ 

| JNF_COCOA_ENTER(env); 

i /*Get the native string from javaString*/ 

[ NSString* nativeString = JNFJavaToNSString(env, javaString); 

i /*Do something with the nativeString*/ 

I / *DON'T FORGET THIS LINE!!!*/ 

I JNF_COCOA_EXIT(env); 

; } 

i__ 

JNI also allows direct access to assembly code, without even going through a C bridge. 

Mapping types 

Native data types can be mapped to/from Java data types. For compound types such as objects, arrays and strings the native code must explicitly convert the data by calling methods in the 
JNiEnv. The following table shows the mapping of types between Java (JNI) and native code. 


Native Type 

JNI Type 

Description 

Type signature 

unsigned char 

jboolean 

unsigned 8 bits 

Z 

signed char 

jbyte 

signed 8 bits 

B 

unsigned short 

jchar 

unsigned 16 bits 

C 

short 

j short 

signed 16 bits 

S 

long 

jint 

signed 32 bits 

I 

long long 
_int64 

jlong 

signed 64 bits 

J 

float 

jfloat 

32 bits 

F 

double 

jdouble 

64 bits 

D 


In addition, the signature "l fuiiy-quaüf ied-ciass ;" would mean the dass uniquely specified by that name; e.g., the signature "l java/iang/string; " refers to the dass 

java. lang. string. Also, prefixing [ to the signature makes the array of that type; for example, [ i means the int array type. Finally, a void signature uses the v code. Here, these types are 

interchangeable. You can use jint where you normally use an int, and vice-versa, without any typecasting required. 

However, mapping between Java Strings and arrays to native strings and arrays is different. If you use a jstring in where a char * would be, your code could crash the JVM. 

I-1 

'JNIEXPORT void JNICALL Java_ClassName_MethodName ' 

i (JNiEnv *env, jobject obj, jstring javaString) { , 

[ // printf("%s", javaString); // INCORRECT: Could crash VM! 1 

, // Correct way: Create and release native string from Java string 

1 const char ‘nativeString = (*env)->GetStringUTFChars (env, javaString, 0); 1 

i printf("%s", nativeString); , 

! (*env)->ReleaseStringUTFChars(env, javaString, nativeString); 1 

! } ; 

i_i 

The encoding used for the NewStringUTF, GetStringUTFLength, Get St ringUTFChar s, ReleaseSt ringUTFChar s, GetStringUTFRegion functions is not Standard UTF-8, but modified 
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UTF-8. The null character (U+0000) and codepoints greater than or equal to U+10000 are encoded differently in modified UTF-8. Many programs actually use these functions incorrectly 
and treat the UTF-8 strings returned or passed into the functions as Standard UTF-8 strings instead of modified UTF-8 strings. Programs should use the Newstring, GetstringLength, 
GetStringChars, ReleaseStringChars, GetStringRegion, GetStringCritical, and ReleaseStringCritical functions, which USe UTF-16LE encoding On Üttle-endian architectures 
and UTF-16BE on big-endian architectures, and then use a UTF-16 to Standard UTF-8 conversion routine. 


The code is similar with Java arrays, as illustrated in the example below that takes the sum of all the elements in an array. 



JNIEXPORT jint JNICALL Java_IntArraY_sumArray 


(JNIEnv *env, jobject obj, jintArray arr) { 
jint buf[10]; 
jint i, sum = 0; 

// This line is necessary , since Java arrays are not guaranteed 
// to have a continuous memory layout like C arrays. 
env->GetIntArrayRegion(arr, 0, 10, buf); 

for (i = 0; i < 10; i++) { 

sum += buf [i]; 

} 

return sum; 


} 



Of course, there is much more to it than this. 


JNIEnv* 


A JNI environment pointer (jNiEnv*) is passed as an argument for each native function mapped to a Java method, allowing for interaction with the JNI environment within the native 
method. This JNI interface pointer can be stored, but remains valid only in the current thread. Other threads must first call AttachCurrentThread () to attach themselves to the VM and 
obtain a JNI interface pointer. Once attached, a native thread works like a regulär Java thread running within a native method. The native thread remains attached to the VM until it calls 

DetachCurrentThread () tO detach itself. 


To attach to the current thread and get a JNI interface pointer: 


jjNIEnv *env; 

1 (*g_vm)->AttachCurrentThread (g_vm, (void **) &env, NULL); 

l_ 

To detach from the current thread: 


>(*g_vm)->DetachCurrentThread (g_vm); 

i 

L_ 


~l 


1 


HeUoWorld 

Code listing 10.1: HelloWorld.java 

i-1 

■ 

1 1 public dass HelloWorld { 

| 2 private native void print (); 

| 3 

| 4 public static void main (String[] args) { 

, 5 new HelloWorld() .print (); 

! 6 } 

| 7 

i 8 static { 

i 9 System. loadLibrary (" HelloWorld") ; 

IlO } 

In } 


HelloWorld.h 


/* DO NOT EDIT THIS FILE - it is machine generated */ 
#include <jni.h> 

/* Header for dass HelloWorld */ 

#ifndef _Included_HelloWorld 
fdefine _Included_HelloWorld 
#ifdef _cplusplus 

extern "C" { 

#endif 

* dass: HelloWorld 

* Method: print 

* Signature : ()V 

JNIEXPORT void JNICALL Java_HelloWorld_print 
(JNiEnv *, jobject); 

#ifdef _cplusplus 

} 

#endif 
#endif 


libHello World, c 

,-, 

' #include <stdio.h> i 

! #include "HelloWorld.h" j 

I JNIEXPORT void JNICALL I 

i Java_HelloWorld_print (JNiEnv *env, jobject obj) [ 

I { I 

i printf ( "Hello World! \n"); ! 

! return; ; 



make.sh 


-, 

# !/bin/sh i 

# openbsd 4.9 1 

# gcc 4.2.1 I 

# openjdk 1.7.0 j 

JAVA_HOME=$(readlink -f /usr/bin/javac I sed " s : bin/javac ::" ) 1 

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH :. ! 

javac HelloWorld.java 1 

javah HelloWorld i 

gcc -I ${ JAVA_HOME }/ include -shared libHelloWorld.c -o 1ibHelloWorld.so | 

java HelloWorld 1 
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Commands to execute on POSIX 


chmod +x make.sh 
./make.sh 


Advanced uses 

Not only can native code interface with Java, it can also draw on a oracle Java API: java.awt.Canvas (http://docs.oracle.eom/javase/7/docs/api/java/awt/Canvas.html), which is possible 
with the Java AWT Native Interface. The process is almost the same, with just a few changes. The Java AWT Native Interface is only available since J2SE 1.3. 


Invoking C 


You can use Runtime. exec () method to invoke a program from within a running Java application. Runtime. exec () also allows you to perform operations related to the program, such as 
control the program's Standard input and output, wait until it completes execution, and get its exit Status. 

Here's a simple C application that illustrates these features. This C program will be called from Java: 


#include <stdio.h> 

int raain () { 

printf ( "testing\n" ); 

return 0; 

} 


This application writes a string "testing" to Standard output, and then terminates with an exit Status of 0. To execute this simple program within a Java application, compile the C application: 



Compilation 


i-1 

i 1 

i$ cc test.c -o test 1 

i 1 

L_! 


Then invoke the C program using this Java code: 

Code listing 10.2: Invoking C programs. 


1 Import java.io.InputStream; 

2 Import java.io.BufferedReader ; 

3 import java.io.InputStreamReader ; 

4 import java.io.IOException; 

5 import java.io.InterruptedException; 

6 import java.io.Process ; 

7 import java.io.Runtime ; 

8 

9 import java.util.ArrayList ; 

10 

11 public dass ExecDemo { 

12 public static String[] runCommand (String emd) throws IOException { 

13 // - set up list to capture command output lines - 

14 ArrayList list = new ArrayList (); 

15 

16 // - Start command running 

17 Process proc = Runtime. getRuntime (). exec (emd); 

18 

19 // - get command's output stream and 

20 // put a buffered reader input stream on it - 

21 InputStream istr = proc. getlnputStream (); 

22 BufferedReader br = new BufferedReader (new InputStreamReader(istr)); 

23 

24 // - read output lines from command 

25 String str; 

26 while ((str = br. readLine ()) != null) { 

27 list. add (str); 

28 } 

29 

30 // wait for command to terminate 

31 try { 

32 proc. waitFor (); 

33 } 

34 catch (InterruptedException e) { 

35 System. err . printin ( "process was interrupted" ); 

36 } 

37 

38 // 

39 if 

40 

41 } 


i4 2 



i4 3 

// 

dose stream 

i4 4 

br . 

close (); 

i4 5 



i4 6 

// 

return list of strings to caller 

i4 7 

return (String[])list. toArray (new String[0]); 

■4 8 

} 


'4 9 



'50 

public 

static void main (String args[]) throws IOException 

'51 

try 

{ 

|52 



[5 3 


// run a command 

[54 


String outlist [] = runCommand( "test") ; 

[5 5 



|5 6 


// display its output 

|57 


for (int i = 0; i < outlist. length ; i++) 

|5 8 


System.out. printin (outlist[i]); 

|5 9 

} 



check its exit value 
(proc. exitValue () != 0) { 

System. err . println (" exit value was non-zero") ; 
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60 catch (IOException e) { 

61 System. err . println (e); 

62 } 

63 } 

64 } 


The demo calls a method runcommand to actually run the program. 



Code section 10.1: Running a command. 



'1 String outlistf] = runCommand( "test") ; i 



This method hooks an input stream to the program's output stream, so that it can read the program's output, and save it into a list of strings. 

Code section 10.2: Reading the program's output. 


jl InputStream istr = proc. getlnputStream (); 

i2 BufferedReader br = new BufferedReader (new InputStreamReader(istr)); 

|3 

|4 String str; 

i5 while ((str = br. readLine ()) != null) { 

|6 list. add (str) ; 

'7 } 

i 



Migrating C to Java 

Tools exist to aid the migration of existing projects from C to Java. In general, automated translator tools fall into one of two distinct kinds: 

■ One kind converts C code to Java byte code. It is basically a Compiler that creates byte code. It has the same Steps as any other C Compiler. See also C to Java JVM Compilers. 

■ The other kind translates C code to Java source code. This type is more complicated and uses various syntax rules to create readable Java source code. This Option is best for those 
who want to move their C code to Java and stay in Java. 


Byte Code 


Java Byte Code is the language to which Java source is compiled and the Java Virtual Machine understands. Unlike compiled languages that have to be 
specifically compiled for each different type of Computers, a Java program only needs to be converted to byte code once, after which it can run on any 
platform for which a Java Virtual Machine exists. 

Bytecode is the compiled format for Java programs. Once a Java program has been converted to bytecode, it can be transferred across a network and 
executed by Java Virtual Machine (JVM). Bytecode files generally have a .dass extension. It is not normally necessary for a Java programmer to know 
byte code, but it can be useful. 

Other Languages 

There are a number of exciting new languages being created that also compile to Java byte code, such as Groovy. 

GNAT 

The GNU Ada-Compiler, is capable of compiling Ada into Java-style bytecode. 
ftp://cs.nyu.edu/pub/gnat 


Topics: 

■ Preface 

■ Getting started 

■ Language fundamentals 

■ Classes and objects 

■ Aggregate 

■ Exceptions 

■ Concurrent Programming 

■ Javadoc & Annotations 

■ Designing user interfaces 

■ Advanced topics 


JPython 

Compiles Python to Java-style bytecode. 
http://www.jpython.org/ 


Kawa 

Compiles Scheme to Java-style bytecode. 
http ://ww w. gnu. org/ software/kawa/ 


Example 

Consider the following Java code. 


outer: 

for (int i = 2; i < 1000; i++) { 

for (int j = 2; j < i; j++) { 

if (i % j == 0) 
continue outer; 

} 

System. out . println (i); 

} 


A Java Compiler might translate the Java code above into byte code as follows, assuming the above was put in a method: 


Code : 

0: iconst_2 

1 : istore_l 

2 : iload_l 

3: sipush 1000 

6: if_icmpge 4 4 

9: iconst_2 

10: istore_2 

11: iload_2 

12: iload_l 

13: if_icmpge 31 

16: iload_l 

17: iload_2 


i 


66 sur 77 


30/01/2016 20:10 




















Java Programming/Print version2 - Wikibooks, open books for an open... 


https://en. wikibooks .org/w/index.php ?title=Java_Programming/Print_ve... 


18 

19 

22 

25 

28 

31 

34 

35 
38 
41 
44 


irem 
i f ne 
goto 
iinc 
goto 


25 

38 

2 , 

11 


getstatic 
iload_l 
invokevirtual 
iinc 1, 1 

goto 2 

return 


# remainder 

#84; //Field java/lang/System.out:Ljava/io/PrintStream; 
#85; //Method java/io/PrintStream.println:(I)V 


Example 2 


As an example we can write a simple Foo.java source: 


public dass Foo { 

public static void main (final String[] args) { 

System. out . println (" This is a simple example of decompilation using javap"); 
a () ; 
b () ; 

} 

public static void a() { 

System. out . printin ( "Now we are calling a function 


public static void b() { 

System. out . println ("... and now we are calling b"); 

} 


Compile it and then move Foo.java to another directory or delete it if you wish. What can we do with javap and Foo.dass ? 


'$javap Foo 


produces this result: 


Compiled from "Foo.java" 

public dass Foo extends java.lang.Object { 
public Foo (); 

public static void main ( java.lang.String[]); 
public static void a(); 
public static void b(); 

} 


As you can see the javac Compiler doesn't Strip any (public) variable name from the .dass file. As a result the names of the functions, their parameters and types of return are exposed. (This 
is necessary in order for other classes to access them.) 

Let's do a bit more, try: 

i-- 

■ 

'$javap -c Foo 


Compiled from "Foo.java" 

public dass Foo extends java . lang . Ob ject { 
public Foo (); 

Code : 


public static void main ( java.lang.String[]); 


aload_0 

invokespecial 

return 


#1; //Method java/lang/Object."<init>":()V 


Code : 
0 : 

3 
5 
8 
11 : 
14 : 


getstatic 

ldc 

invokevirtual 

invokestatic 

invokestatic 

return 


public static void a(); 
Code : 


getstatic 

ldc 

invokevirtual 

return 


Code : 
0 
3 
5 


getstatic 

ldc 

invokevirtual 

return 


# 2 ; 

#3; 

#4; 

#5; 

# 6 ; 


# 2 ; 


//Field j ava/lang/System.out:Lj ava/io/PrintStream; 

//String This is a simple example of decompilation using javap 
//Method java/io/PrintStream.println: (Ljava/lang/String;)V 
//Method a:()V 
//Method b:()V 


public static void b(); 


//Field java/lang/System.out:Ljava/io/PrintStream; 

#7; //String Now we are calling a function... 

#4; //Method java/io/PrintStream.println: (Ljava/lang/String;)V 


#2; //Field java/lang/System.out:Ljava/io/PrintStream; 

#8; //String ...and now we are calling b 

#4; //Method java/io/PrintStream.println:(Ljava/lang/String;)V 


The Java bytecodes 


See Oracle's Java Virtual Machine Specificationl 1 Ifor more detailed descriptions 

The manipulation of the Operand stack is notated as [before]—dafter], where [before] is the stack before the instruction is executed and [after] is the stack after the instruction is executed. 
A stack with the element 'b' on the top and element ’a’ just after the top element is denoted ’a,b’. 
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Mnemonic 

aaload 

aastore 

aconst_null 

aload 

aload_0 

aload_l 

aload_2 

aload_3 

anewarray 

areturn 

arraylength 

astore 

astore_0 

astore_l 

astore_2 

astore_3 

athrow 

baload 

bastore 

bipush 

c aload 
c astore 

checkcast 

d2f 

d2i 

d21 

dadd 

daload 

dastore 

dcmpg 

dcmpl 

dconst_0 

dconst_l 

ddiv 

dload 

dload_0 

dload_l 

dload_2 

dload_3 

dmul 

dneg 

drem 

dreturn 

dstore 

dstore_0 

dstore_l 

dstore_2 

dstore_3 

dsub 

dup 

dup_xl 

dup_x2 

dup2 


Opcode 

(in hex) 

Other bytes 

Stack 

[before]—>[after] 

Description 


A 


2b 

2c 

2d 


4c 

4d 

4e 


bf 


32 
53 
01 

19 lindex 
2a 


bd indexbytel, indexbyte2 


bO 
be 

3 a index 

4b 


arrayref, index —» value 


arrayref, index, value 
—> null 
—> objectref 
—► objectref 
—> objectref 
—> objectref 
—► objectref 


count —> arrayref 


objectref —> [empty] 


arrayref —> length 
objectref —> 
objectref —> 


objectref 


objectref 


objectref 


objectref —> [empty], objectref 


B 


loads onto the stack a reference from an array 

Stores a reference into an array 

pushes a null reference onto the stack 

loads a reference onto the stack from a local variable #index 

loads a reference onto the stack from local variable 0 

loads a reference onto the stack from local variable 1 

loads a reference onto the stack from local variable 2 

loads a reference onto the stack from local variable 3 

creates a new array of references of length count and component type 
identified by the dass reference index (indexbytel « 8 + indexbyte2) in the 
constant pool 

returns a reference from a method 

gets the length of an array 

Stores a reference into a local variable #index 

Stores a reference into local variable 0 

Stores a reference into local variable 1 

Stores a reference into local variable 2 

Stores a reference into local variable 3 

throws an error or exception (notice that the rest of the stack is cleared, 
leaving only a reference to the Throwable) 


33 


arrayref, index —> value 

loads a byte or Boolean value from an array 

54 


arrayref, index, value —> 

Stores a byte or Boolean value into an array 

10 

byte 

—» value 

pushes a byte onto the stack as an integer value 


C 


34 


arrayref, index —> value 

loads a char from an array 

55 


arrayref, index, value —> 

Stores a char into an array 

cO 

indexbytel, indexbyte2 

objectref —» objectref 

checks whether an objectref is of a certain type, the dass reference of which 
is in the constant pool at index (indexbytel « 8 + indexbyte2 ) 


D 


90 


value —> result 

8e 


value —> result 

8f 


value —> result 

63 


value 1, value2 —» result 

31 


arrayref, index —> value 

52 


arrayref, index, value —> 

98 


value 1, value2 —> result 

97 


value 1, value2 —> result 

Oe 


^0.0 

Of 


1.0 

6f 


value 1, value2 —> result 

18 

index 

—> value 

26 


—> value 

27 


—> value 

28 


—> value 

29 


—> value 

6b 


value 1, value2 —> result 

77 


value —> result 

73 


value 1, value2 —> result 

af 


value —> [empty] 

39 

index 

value —> 

47 


value —» 

48 


value —» 

49 


value —> 

4a 


value —» 

67 


value 1, value2 —» result 

59 


value —> value, value 

5a 


value2, value 1 —> value 1, 
value2, value 1 

5b 


value3, value2, value 1 —> 
value 1, value3, value2, value 1 

5c 


{value2, value 1} —► {value2, 
value 1}, {value2, value 1} 


converts a double to a float 

converts a double to an int 

converts a double to a long 

adds two double s 

loads a double from an array 

Stores a double into an array 

compares two doubles 

compares two doubles 

pushes the constant 0.0 onto the stack 

pushes the constant 1.0 onto the stack 

divides two doubles 

loads a double value from a local variable #index 

loads a double from local variable 0 

loads a double from local variable 1 

loads a double from local variable 2 

loads a double from local variable 3 

multiplies two doubles 

negates a double 

gets the remainder from a division between two doubles 

returns a double from a method 

Stores a double value into a local variable #index 

Stores a double into local variable 0 

Stores a double into local variable 1 

Stores a double into local variable 2 

Stores a double into local variable 3 

subtracts a double from another 

duplicates the value on top of the stack 

inserts a copy of the top value into the stack two values from the top 

inserts a copy of the top value into the stack two (if value2 is double or long it 
takes up the entry of value3, too) or three values (if value2 is neither double 
nor long) from the top 

duplicate top two stack words (two values, if value 1 is not double nor long; a 
single value, if value 1 is double or long) 
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dup2_xl 

5d 


value3, {value2, value 1} —> 

{value2, value 1}, value3, 
{value2, value 1} 

duplicate two words and insert beneath third word (see explanation above) 

dup2_x2 

5e 


{value4, value3}, {value2, 
value 1} —» {value2, value 1}, 

{value4, value3}, {value2, 
value 1} 

duplicate two words and insert beneath fourth word 


F 


f2d 

8d 

f2i 

8b 

f21 

8c 

fadd 

62 

faload 

30 

fastore 

51 

fcmpg 

96 

fcmpl 

95 

fconst_0 

Ob 

fconst_l 

0c 

fconst_2 

Od 

fdiv 

6e 

fload 

17 

fload_0 

22 

fload_l 

23 

fload_2 

24 

fload_3 

25 

fmul 

6a 

fneg 

76 

frem 

72 

freturn 

ae 

fstore 

38 

fstore_0 

43 

fstore_l 

44 

fstore_2 

45 

fstore_3 

46 

fsub 

66 


index 


index 


value —> result 
value —> result 
value —> result 
value 1, value2 —> result 
arrayref, index —» value 
arreyref, index, value —; 
value 1, value2 —> result 
value 1, value2 —► result 
-►O.Of 
l.Of 
—>2.0f 


value 1, value2 
—> value 
—> value 
—> value 
—> value 
—> value 


value 1, value2 
value —> result 


value 1, value2 —> 
value —» [empty] 
value —> 
value —> 


value 


value 


value —» 
value 1, value2 


result 


result 


result 


result 


converts a float to a double 
converts a float to an int 
converts a float to a long 
adds two floats 
loads a float from an array 
Stores a float in an array 
compares two floats 
compares two floats 
pushes 0.0/on the stack 
pushes l.Of on the stack 
pushes 2.0/ on the stack 
divides two floats 

loads a float value from a local variable #index 
loads a float value from local variable 0 
loads a float value from local variable 1 
loads a float value from local variable 2 
loads a float value from local variable 3 
multiplies two floats 
negates a float 

gets the remainder from a division between two floats 

returns a float from method 

Stores a float value into a local variable #index 

Stores a float value into local variable 0 

Stores a float value into local variable 1 

Stores a float value into local variable 2 

Stores a float value into local variable 3 

subtracts two floats 


G 


getfield 

b4 

index 1, index2 

objectref —» value 

gets a field value of an object objectref, where the field is identified by field 
reference in the constant pool index (index 1 « 8 + index2 ) 

getstatic 

b2 

index 1, index2 

—> value 

gets a static field value of a dass, where the field is identified by field 
reference in the constant pool index (index 1 « 8 + index2 ) 

goto 

a7 

branchbytel, branchbyte2 

[no change] 

goes to another instruction at branchoffset (signed short constructed from 
unsigned bytes branchbytel « 8 + branchbyte2 ) 

goto_w 

c8 

branchbytel, branchbyte2, branchbyte3, 
branchbyte4 

[no change] 

goes to another instruction at branchoffset (signed int constructed from 
unsigned bytes branchbytel «24 + branchbyte2 « 16 + branchbyte3 «8 
+ branchbyte4) 


I 


i2b 

91 

i2c 

92 

i2d 

87 

i2f 

86 

i21 

85 

i2s 

93 

iadd 

60 

iaload 

2e 

iand 

7e 

iastore 

4f 

iconst_ml 

02 

iconst_0 

03 

iconst_l 

04 

iconst_2 

05 

iconst_3 

06 

iconst_4 

07 

iconst_5 

08 

idiv 

6c 

if_acmpeq 

a5 

if_acmpne 

a6 


branchbytel, branchbyte2 
branchbytel, branchbyte2 


value 

value 

value 

value 

value 

value 


result 
result 
result 
result 
result 
result 

value 1, value2 —> result 
arrayref, index —» value 
value 1, value2 —> result 
arrayref, index, value —> 
-»-1 
-> 0 
1 

—> 2 
->3 
—> 4 
—► 5 

value 1, value2 —> result 


value 1, value2 


value 1, value2 


converts an int into a byte 
converts an int into a character 
converts an int into a double 
converts an int into a float 
converts an int into a long 
converts an int into a short 
adds two ints together 
loads an int from an array 
performs a logical and on two integers 
Stores an int into an array 
loads the int value -1 onto the stack 
loads the int value 0 onto the stack 
loads the int value 1 onto the stack 
loads the int value 2 onto the stack 
loads the int value 3 onto the stack 
loads the int value 4 onto the stack 
loads the int value 5 onto the stack 
divides two integers 

if references are equal, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel < < 8 + branchbyte2 ) 

if references are not equal, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel < < 8 + branchbyte2 ) 
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if_icmpeq 

if_icmpne 

if_icmplt 

if_icmpge 

if_icmpgt 

if_icmple 

ifeq 

ifne 

iflt 

ifge 

ifgt 

ifle 

ifnonnull 

ifnull 

iinc 

iload 

iload_0 

iload_l 

iload_2 

iload_3 

imul 

ineg 

instanceof 

invokeinterface 


invokespecial 

invokestatic 

invokevirtual 

ior 

irem 

ireturn 

ishl 

ishr 

istore 

istore_0 

istore_l 

istore_2 

istore_3 

isub 

iushr 

ixor 

jsr 


9f 

branchbytel, branchbyte2 

valuel, value2 

aO 

branchbytel, branchbyte2 

valuel, value2 

al 

branchbytel, branchbyte2 

valuel, value2 

a2 

branchbytel, branchbyte2 

valuel, value2 

a3 

branchbytel, branchbyte2 

valuel, value2 

a4 

branchbytel, branchbyte2 

valuel, value2 

99 

branchbytel, branchbyte2 

value —> 

9a 

branchbytel, branchbyte2 

value —> 

9b 

branchbytel, branchbyte2 

value —» 

9c 

branchbytel, branchbyte2 

value —> 


9d branchbytel, branchbyte2 


value 


9e branchbytel, branchbyte2 

c7 branchbytel, branchbyte2 

c6 branchbytel, branchbyte2 

84 index, const 
15 index 

la 
lb 


lc 

ld 

68 

74 


value —> 

value —> 

value —> 

[No change] 
—> value 
—> value 
—» value 
—> value 
—> value 


value 1, value2 


value —> result 


cl indexbytel, indexbyte2 


objectref —» result 


result 


b9 indexbytel, indexbyte2, count, 0 objectref, [argl, arg2,...] 


b7 indexbytel, indexbyte2 


objectref, [argl, arg2,...] 


b8 indexbytel, indexbyte2 


[argl, arg2, ...] 


b6 indexbytel, indexbyte2 

80 

70 

ac 

78 

7a 

36 index 
3b 
3c 
3d 
3e 
64 
7c 
82 


objectref, [argl, arg2,...] 

value 1, value2 —> result 

value 1, value2 —» result 

value —> [empty] 

value 1, value2 —> result 

value 1, value2 —► result 

value —> 

value —> 

value —> 

value —> 

value —> 

value 1, value2 —» result 
value 1, value2 —> result 
value 1, value2 —> result 


if ints are equal, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel << 8 + branchbyte2 ) 

if ints are not equal, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel < < 8 + branchbyte2 ) 

if value 1 is less than value2, branch to instruction at branchoffset (signed 
short constructed from unsigned bytes branchbytel « 8 + branchbyte2) 

if valuel is greater than or equal to value2, branch to instruction at 
branchoffset (signed short constructed from unsigned bytes branchbytel «8 
+ branchbyte2 ) 

if valuel is greater than value2, branch to instruction at branchoffset (signed 
short constructed from unsigned bytes branchbytel « 8 + branchbyte2 ) 

if valuel is less than or equal to value2, branch to instruction at branchoffset 
(signed short constructed from unsigned bytes branchbytel « 8 + 
branchbyte2 ) 

if value is 0, branch to instruction at branchoffset (signed short constructed 
from unsigned bytes branchbytel « 8 + branchbyte2 ) 

if value is not 0, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel < < 8 + branchbyte2 ) 

if value is less than 0, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel < < 8 + branchbyte2 ) 

if value is greater than or equal to 0, branch to instruction at branchoffset 
(signed short constructed from unsigned bytes branchbytel « 8 + 
branchbyte2 ) 

if value is greater than 0, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel < < 8 + branchbyte2 ) 

if value is less than or equal to 0, branch to instruction at branchoffset (signed 
short constructed from unsigned bytes branchbytel « 8 + branchbyte2 ) 

if value is not null, branch to instruction at branchoffset (signed short 
constructed from unsigned bytes branchbytel << 8 + branchbyte2 ) 

if value is null, branch to instruction at branchoffset (signed short constructed 
from unsigned bytes branchbytel « 8 + branchbyte2 ) 

increment local variable #index by signed byte const 

loads an int value from a variable #index 

loads an int value from variable 0 

loads an int value from variable 1 

loads an int value from variable 2 

loads an int value from variable 3 

multiply two integers 

negate int 

determines if an object objectref is of a given type, identified by dass 
reference index in constant pool ( indexbytel « 8 + indexbyte2 ) 

invokes an interface method on object objectref, where the interface method is 
identified by method reference index in constant pool ( indexbytel « 8 + 
indexbyte2) and count is the number of arguments to pop from the stack frame 
including the object on which the method is being called and must always be 
greater than or equal to 1 

invoke instance method on object objectref requiring special handling 
(instance initialization method, a private method, or a superclass method), 
where the method is identified by method reference index in constant pool 
(i indexbytel « 8 + indexbyte2 ) 

invoke a static method, where the method is identified by method reference 
index in constant pool ( indexbytel « 8 + indexbyte2 ) 

invoke virtual method on object objectref, where the method is identified by 
method reference index in constant pool ( indexbytel « 8 + indexbyte2 ) 

logical int or 

logical int remainder 

returns an integer from a method 

int shift left 

int shift right 

störe int value into variable #index 
störe int value into variable 0 
störe int value into variable 1 
störe int value into variable 2 
störe int value into variable 3 
int subtract 
int shift right 
int xor 


J 





jump to subroutine at branchoffset (signed short constructed from unsigned 

a8 

branchbytel, branchbyte2 

—> address 

bytes branchbytel « 8 + branchbyte2 ) and place the return address on the 
stack 
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jsr_w 


c9 


branchbytel, branchbyte2, branchbyte3, 
branchbyte4 


address 


12d 

12f 

12i 

ladd 

laload 

land 

lastore 

lcmp 

lconst_0 

lconst_l 

ldc 

ldc w 


8a 

89 

88 

61 

2f 

7f 

50 

94 

09 


0a 


12 index 


13 indexbytel, indexbyte2 


value 


result 
result 
value —> result 


value 


value 1, value2 


arrayref, index 


value 1, value2 


result 

value 

result 


arrayref, index, value —> 
value 1, value2 —> result 
—> OL 
1L 

—> value 

—> value 


ldc2_w 

ldiv 

lload 

lload_0 

lload_l 

lload_2 

lload_3 

lmul 

lneg 

lookupswitch 

lor 

Ire in 

lreturn 

lshl 

lshr 

lstore 

lstore_0 

lstore_l 

lstore_2 

lstore_3 

lsub 

lushr 

lxor 


14 indexbytel, indexbyte2 


6d 

16 

le 

lf 

20 

21 

69 

75 

ab 

81 

71 

ad 

79 

7b 

37 

3f 

40 

41 

42 
65 
7d 
83 


index 


<0-3 bytes padding>, defaultbytel, 
defaultbyte2, defaultbyte3, defaultbyte4, 
npairsl, npairs2, npairs3, npairs4, match- 
offset pairs... 


index 


value 


value 1, value2 
—> value 
—> value 
—> value 
—> value 
—> value 
value 1, value2 
value —> result 


result 


result 


key —> 

value 1, value2 —> 
value 1, value2 —> 
value —> [empty] 


value 1, value2 


value 1, value2 
value —> 
value —> 
value —» 
value —> 


result 

result 

result 

result 


value 


value 1, value2 


value 1, value2 


value 1, value2 


result 

result 

result 


jump to subroutine at branchoffset (signed int constructed from unsigned bytes 
branchbytel « 24 + branchbyte2 « 16 + branchbyte3 « 8 + 
branchbyte4 ) and place the return address on the stack 

converts a long to a double 
converts a long to a float 
converts a long to an int 
add two longs 
load a long from an array 
bitwise and of two longs 
störe a long to an array 
compares two longs values 
pushes the long 0 onto the stack 
pushes the long 1 onto the stack 

pushes a constant #index from a constant pool (String, int, float or dass type) 
onto the stack 

pushes a constant #index from a constant pool (String, int, float or dass type) 
onto the stack (wide index is constructed as indexbytel « 8 + indexbyte2 ) 

pushes a constant #index from a constant pool (double or long) onto the stack 
(wide index is constructed as indexbytel « 8 + indexbyte2 ) 

divide two longs 

load a long value from a local variable #index 
load a long value from a local variable 0 
load a long value from a local variable 1 
load a long value from a local variable 2 
load a long value from a local variable 3 
multiplies two longs 
negates a long 

a target address is looked up from a table using a key and execution continues 
from the instruction at that address 

bitwise or of two longs 
remainder of division of two longs 
returns a long value 

bitwise shift left of a long value 1 by value2 positions 

bitwise shift right of a long value 1 by value2 positions 

störe a long value in a local variable #index 

störe a long value in a local variable 0 

störe a long value in a local variable 1 

störe a long value in a local variable 2 

störe a long value in a local variable 3 

subtract two longs 

bitwise shift right of a long value 1 by value2 positions, unsigned 
bitwise exclusive or of two longs 


M 


monitorenter 

c2 


objectref —» 

enter monitor for object ("grab the lock" - Start of synchronized() section) 

monitorexit 

c3 


objectref —> 

exit monitor for object ("release the lock" - end of synchronized() section) 

multianewarray 

c5 

indexbytel, indexbyte2, dimensions 

countl, [count2,...] - 

-> arrayref 

create a new array of dimensions dimensions with elements of type identified 
by dass reference in constant pool index (indexbytel « 8 + indexbyte2 ); the 
sizes of each dimension is identified by countl, [count2, etc] 


N 


new 

bb 

indexbytel, indexbyte2 

—> objectref 

creates new object of type identified by dass reference in constant pool index 
(i indexbytel « 8 + indexbyte2 ) 

newarray 

bc 

atype 

count —► arrayref 

creates new array with count elements of primitive type identified by atype 

nop 

00 


[No change] 

performs no Operation 


P 


pop 

57 


value —» 

discards the top value on the stack 

pop2 

58 


{value2, value 1} —> 

discards the top two values on the stack (or one value, if it is a double or long) 

putfield 

b5 

indexbytel, indexbyte2 

objectref, value —> 

set field to value in an object objectref, where the field is identified by a field 
reference index in constant pool (indexbytel « 8 + indexbyte2 ) 

putstatic 

b3 

indexbytel, indexbyte2 

value —» 

set static field to value in a dass, where the field is identified by a field 
reference index in constant pool (indexbytel « 8 + indexbyte2 ) 


R 


ret 

a9 

index 

[No change] 

continue execution from address taken from a local variable #index (the 
asymmetry with jsr is intentional) 

return 

bl 


[empty] 

return void from method 

S 
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saload 

35 


arrayref, index —> value 

load short from array 

sastore 

56 


arrayref, index, value —> 

störe short to array 

sipush 

11 

bytel, byte2 

—» value 

pushes a signed integer (bytel « 8 + byte2 ) onto the stack 

swap 

5f 


value2, value 1 —> value 1, 
value2 

swaps two top words on the stack (note that value 1 and value2 must not be 
double or long) 


T 




[0-3 bytes padding], defaultbytel, 
defaultbyte2, defaultbyte3, defaultbyte4, 



tableswitch 

aa 

lowbytel, lowbyte2, lowbyte3, lowbyte4, 
highbytel, highbyte2, highbyte3, highbyte4, 
jump offsets... 

index —> 

continue execution from an address in the table at offset index 


W 




opcode, indexbytel, indexbyte2 


execute opcode, where opcode is either iload, fload, aload, lload, dload, istore, 

wide 

c4 

or 

[same as for corresponding 

fstore, astore, Istore, dstore, or ret, but assume the index is 16 bit; or execute 

iinc, indexbytel, indexbyte2, countbyte 1, 

instructions] 

iinc, where the index is 16 bits and the constant to increment by is a signed 16 



countbyte2 


bit short 


Unused 


breakpoint 

ca 



reserved for breakpoints in Java debuggers; should not appear in any dass file 

impdepl 

fe 



reserved for implementation-dependent operations within debuggers; should 
not appear in any dass file 

impdep2 

ff 



reserved for implementation-dependent operations within debuggers; should 
not appear in any dass file 

(no name) 

cb-fd 



these values are currently unassigned for opcodes and are reserved for future 

use 

xxxunusedxxx 

ba 



this opcode is reserved "for historical reasons" 
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Glossary 

This is a glossary of the book. 

Contents: Top-0-9ABCDEFGHIJKLMNOPQRSTUVWXYZ 


A 


annotation 

A means of attaching metadata to methods and classes directly in the source code. 


B 

byte code 

Code interpreted by the Java virtual machine; the target code of Java Compilation. 


G 


generics 

A means of passing a data type as an argument of another type, such as Vector<JButton>; 


P 

primitive type 

One of the types that do not require allocation on stack, such as int, byte, or long. 


R 


reflection 


A way of treating classes and methods as objects on their own, to be referred to during runtime, for instance by quering a particular dass about its methods and their parameters. 


Index 


This is an alphabetical index to the book. 

Contents: Top - 0-9 ABCDEFGHIJKLMNOPQRSTUVWXYZ 


A 

■ abstract 

■ Arrays 

■ ArrayList 

■ assert 

B 

■ base dass 

■ boolean 

■ break 

■ byte 

C 

■ case 

■ catch 

■ char 

■ dass 

■ ClassLoader 

■ Collections 

■ const 

■ continue 


K 

■ Keywords 

L 

■ List 

■ LinkedList 

■ long 

M 

■ Map 

■ Methods 

N 

■ native 

■ new 

■ Nested Classes 

P 


■ package 
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D 

■ default 

■ do 

■ double 

■ Dynamic Class Loading 


■ eise 

■ enum 

■ Exceptions 

■ Throwing and Catching 

■ Examples: 

■ Rounding number example 

■ Singleton example 

■ extends 

F 

■ final 

■ finally 

■ float 

■ for 

G 

■ Generics 

■ goto 

I 


■ if 

■ implements 

■ import 

■ int 

■ interface 


■ parent class 

■ Primitive Types 

■ private 

■ protected 

■ public 


Q 

■ Queue 

R 

■ return 

S 

■ Set 

■ short 

■ Stack 

■ static 

■ strictfp 

■ super 

■ superclass 

■ switch 

■ synchronized 

T 

■ this 

■ throw 

■ throws 

■ transient 

■ try 

V 


■ Variable arity (varargs) 

■ Variable number of arguments 

■ Vector 

■ void 

■ volatile 


GNU Free Documentation License 

Version 1.3, 3 November 2008 Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. <http://fsf.org/> 
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. 

0. PREAMBLE 


The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and 
redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, 
while not being considered responsible for modifications made by others. 

This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which 
is a copyleft license designed for free Software. 

We have designed this License in order to use it for manuals for free Software, because free Software needs free documentation: a free program should come with manuals providing the 
same freedoms that the Software does. But this License is not limited to Software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a 
printed book. We recommend this License principally for works whose purpose is instruction or reference. 


1. APPLICABILITY AND DEFINITIONS 


This License applies to any manual or other work, in any medium, that contains a notice placed by the Copyright holder saying it can be distributed under the terms of this License. Such a 
notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any 
member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under Copyright law. 

A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. 

A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the 
Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a 
Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, 
philosophical, ethical or political position regarding them. 

The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this 
License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document 
does not identify any Invariant Sections then there are none. 

The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A 
Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words. 

A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the 
document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable 
for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or 


74 sur 77 


30/01/2016 20:10 


Java Programming/Print version2 - Wikibooks, open books for an open... https://en.wikibooks.org/w/index.php?title=Java_Programming/Print_ve... 


absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount 
of text. A copy that is not "Transparent" is called "Opaque". 

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and 
standard-conforming simple HTML, PostScript or PDL designed for human modification. Examples of transparent image formats include PNG, XCL and JPG. Opaque formats include 
proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the 
machine-generated HTML, PostScript or PDP produced by some word processors for output purposes only. 

The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. Por 
works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the 
text. 


The "publisher" means any person or entity that distributes copies of the Document to the public. 


A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another 
language. (Here XYZ Stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a 
section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition. 


The Document may include Warranty Disclaimers next to the notice which States that this License applies to the Document. These Warranty Disclaimers are considered to be included by 
reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this 
License. 


2. VERBATIM COPYING 


You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the Copyright notices, and the license notice saying this 
License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or 
control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of 
copies you must also follow the conditions in section 3. 

You may also lend copies, under the same conditions stated above, and you may publicly display copies. 

3. COPYING IN QUANTITY 


If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, 
you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Lront-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must 
also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other 
material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim 
copying in other respects. 

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent 
pages. 

If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state 
in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-Standard network protocols a complete 
Transparent copy of the Document, free of added material. If you use the latter Option, you must take reasonably prudent Steps, when you begin distribution of Opaque copies in quantity, to 
ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or 
retailers) of that edition to the public. 

It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated 
Version of the Document. 


4. MODIFICATIONS 


You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this 
License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you 
must do these things in the Modified Version: 

A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History 
section of the Document). You may use the same title as a previous Version if the original publisher of that Version gives permission. 

B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal 
authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement. 

C. State on the Title page the name of the publisher of the Modified Version, as the publisher. 

D. Preserve all the Copyright notices of the Document. 

E. Add an appropriate Copyright notice for your modifications adjacent to the other Copyright notices. 

L. Include, immediately after the Copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the 
Addendum below. 

G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice. 

H. Include an unaltered copy of this License. 

I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title 
Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item 
describing the Modified Version as stated in the previous sentence. 

J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for 
previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the 
Document itself, or if the original publisher of the Version it refers to gives permission. 

K. Por any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor 
acknowledgements and/or dedications given therein. 

L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. 

M. Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version. 

N. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section. 

O. Preserve any Warranty Disclaimers. 

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your Option 
designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any 
other section titles. 

You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties—for example, Statements of peer review or that 
the text has been approved by an Organization as the authoritative definition of a Standard. 

You may add a passage of up to five words as a Lront-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only 
one passage of Lront-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the 
same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit 
permission from the previous publisher that added the old one. 
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The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. 


5. COMBINING DOCUMENTS 


You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the 
combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you 
preserve all their Warranty Disclaimers. 

The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the 
same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, 
or eise a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work. 

In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled 
"Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements". 

6. COLLECTIONS OF DOCUMENTS 


You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a 
single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects. 

You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and 
follow this License in all other respects regarding verbatim copying of that document. 

7. AGGREGATION WITH INDEPENDENT WORKS 


A Compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if 
the Copyright resulting from the Compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an 
aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document. 

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may 
be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed 
covers that bracket the whole aggregate. 


8. TRANSLATION 


Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires 
special permission from their Copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may 
include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English Version of this License 
and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original Version of this License or a notice or disclaimer, the original 
Version will prevail. 

If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the 
actual title. 


9. TERMINATION 

You may not copy, modify, sublicense, or distribute the Document except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, or distribute it is 
void, and will automatically terminate your rights under this License. 

However, if you cease all violation of this License, then your license from a particular Copyright holder is reinstated (a) provisionally, unless and until the Copyright holder explicitly and 
finally terminates your license, and (b) permanently, if the Copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. 

Moreover, your license from a particular Copyright holder is reinstated permanently if the Copyright holder notifies you of the violation by some reasonable means, this is the first time you 
have received notice of violation of this License (for any work) from that Copyright holder, and you eure the violation prior to 30 days after your receipt of the notice. 

Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated 
and not permanently reinstated, receipt of a copy of some or all of the same material does not give you any rights to use it. 

10. FUTURE REVISIONS OF THIS LICENSE 

The Lree Software Loundation may publish new, revised versions of the GNU Lree Documentation License from time to time. Such new versions will be similar in spirit to the present 
Version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. 

Each Version of the License is given a distinguishing Version number. If the Document specifies that a particular numbered Version of this License "or any later Version" applies to it, you 
have the Option of following the terms and conditions either of that specified Version or of any later Version that has been published (not as a draft) by the Lree Software Loundation. If the 
Document does not specify a Version number of this License, you may choose any Version ever published (not as a draft) by the Lree Software Loundation. If the Document specifies that a 
proxy can decide which future versions of this License can be used, that proxy's public Statement of acceptance of a Version permanently authorizes you to choose that Version for the 
Document. 


11. RELICENSING 


"Massive Multiauthor Collaboration Site" (or "MMC Site") means any World Wide Web Server that publishes copyrightable works and also provides prominent facilities for anybody to edit 
those works. A public wiki that anybody can edit is an example of such a Server. A "Massive Multiauthor Collaboration" (or "MMC") contained in the site means any set of copyrightable 
works thus published on the MMC site. 

"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 license published by Creative Commons Corporation, a not-for-profit Corporation with a principal place of business 
in San Lrancisco, California, as well as future copyleft versions of that license published by that same Organization. 

"Incorporate" means to publish or republish a Document, in whole or in part, as part of another Document. 

An MMC is "eligible for relicensing" if it is licensed under this License, and if all works that were first published under this License somewhere other than this MMC, and subsequently 
incorporated in whole or in part into the MMC, (1) had no cover texts or invariant sections, and (2) were thus incorporated prior to November 1, 2008. 

The operator of an MMC Site may republish an MMC contained in the site under CC-BY-SA on the same site at any time before August 1, 2009, provided the MMC is eligible for 
relicensing. 


How to use this License for your documents 

To use this License in a document you have written, include a copy of the License in the document and put the following Copyright and license notices just after the title page: 
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Copyright (c) YEAR YOUR NAME. 

Permission is granted to copy, distribute and/or modify this document 
under the terms of the GNU Free Documentation License, Version E3 
or any later Version published by the Free Software Foundation; 
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. 

A copy of the license is included in the section entitled "GNU 
Free Documentation Ficense". 

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with...Texts." line with this: 

with the Invariant Sections being FIST THEIR TITFES, with the 
Front-Cover Texts being FIST, and with the Back-Cover Texts being FIST. 

If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the Situation. 

If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free Software license, such as the GNU General 
Public Ficense, to permit their use in free Software. 


Retrieved from "https://en.wikibooks.org/w/index.php?title=Java_Programming/Print_version2&oldid=3042144" 
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